prizmkit 1.0.100 → 1.0.102

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.100",
-  "bundledAt": "2026-03-23T15:20:23.258Z",
-  "bundledFrom": "e0c5380"
+  "frameworkVersion": "1.0.102",
+  "bundledAt": "2026-03-24T16:16:55.231Z",
+  "bundledFrom": "b3fb911"
 }

package/bundled/dev-pipeline/launch-daemon.sh

@@ -93,6 +93,7 @@ cmd_start() {
     local feature_list=""
     local env_overrides=""
     local mode_override=""
+    local features_filter=""
 
     # Parse arguments
     while [[ $# -gt 0 ]]; do
@@ -123,6 +124,15 @@ cmd_start() {
                 esac
                 shift
                 ;;
+            --features)
+                shift
+                if [[ $# -eq 0 ]]; then
+                    log_error "--features requires a value (e.g. --features F-001,F-003 or --features F-001:F-010)"
+                    exit 1
+                fi
+                features_filter="$1"
+                shift
+                ;;
             *)
                 feature_list="$1"
                 shift
@@ -199,6 +209,9 @@ cmd_start() {
     log_info "Launching pipeline..."
     log_info "Feature list: $feature_list"
     log_info "Log file: $LOG_FILE"
+    if [[ -n "$features_filter" ]]; then
+        log_info "Features filter: $features_filter"
+    fi
     if [[ -n "$mode_override" ]]; then
         log_info "Mode: $mode_override"
     fi
@@ -212,6 +225,9 @@ cmd_start() {
         echo "================================================================"
         echo "  Pipeline Daemon Started: $start_time"
         echo "  Feature list: $feature_list"
+        if [[ -n "$features_filter" ]]; then
+            echo "  Features filter: $features_filter"
+        fi
         if [[ -n "$mode_override" ]]; then
             echo "  Mode: $mode_override"
         fi
@@ -227,11 +243,17 @@ cmd_start() {
     # is inherited and blocks child claude processes with "nested sessions" error.
     unset CLAUDECODE 2>/dev/null || true
 
+    # Build features flag
+    local features_flag=""
+    if [[ -n "$features_filter" ]]; then
+        features_flag="--features $features_filter"
+    fi
+
     # Launch with nohup + disown for full detachment
     if [[ -n "$env_cmd" ]]; then
-        nohup $env_cmd "$RUN_SCRIPT" run "$feature_list" >> "$LOG_FILE" 2>&1 &
+        nohup $env_cmd "$RUN_SCRIPT" run "$feature_list" $features_flag >> "$LOG_FILE" 2>&1 &
     else
-        nohup "$RUN_SCRIPT" run "$feature_list" >> "$LOG_FILE" 2>&1 &
+        nohup "$RUN_SCRIPT" run "$feature_list" $features_flag >> "$LOG_FILE" 2>&1 &
     fi
     local pipeline_pid=$!
     disown "$pipeline_pid" 2>/dev/null || true
@@ -548,20 +570,23 @@ show_help() {
 Usage: launch-daemon.sh <command> [options]
 
 Commands:
-  start [feature-list.json] [--mode <mode>] [--env "K=V ..."]   Start pipeline in background
+  start [feature-list.json] [--mode <mode>] [--features <filter>] [--env "K=V ..."]   Start pipeline in background
   stop                                            Gracefully stop pipeline
   status                                          Check if pipeline is running
   logs [--lines N] [--follow]                     View pipeline logs
-  restart [feature-list.json] [--mode <mode>] [--env "K=V ..."]  Stop + start pipeline
+  restart [feature-list.json] [--mode <mode>] [--features <filter>] [--env "K=V ..."]  Stop + start pipeline
   help                                            Show this help
 
 Options:
   --mode <lite|standard|full|self-evolve>   Override pipeline mode for all features
+  --features <filter>                       Run only specified features (e.g. F-001,F-003 or F-001:F-010)
   --env "KEY=VAL ..."                        Set environment variables
 
 Examples:
   ./launch-daemon.sh start                        # Start with default feature-list.json
   ./launch-daemon.sh start my-features.json       # Start with custom feature list
+  ./launch-daemon.sh start --features F-001:F-005  # Run only features F-001 through F-005
+  ./launch-daemon.sh start --features F-001,F-003,F-007  # Run specific features
   ./launch-daemon.sh start --mode self-evolve     # Self-evolve mode (framework development)
   ./launch-daemon.sh start --env "MAX_RETRIES=5 SESSION_TIMEOUT=7200"
   ./launch-daemon.sh start feature-list.json --mode self-evolve --env "VERBOSE=1"

package/bundled/dev-pipeline/run.sh

@@ -783,6 +783,7 @@ print(data.get('reload_needed', False))
 
 main() {
     local feature_list="${1:-feature-list.json}"
+    local features_filter="${2:-}"
 
     # Resolve to absolute path
     if [[ ! "$feature_list" = /* ]]; then
@@ -842,6 +843,9 @@ main() {
     echo -e "${BOLD}          Dev-Pipeline Runner Started${NC}"
     echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
     log_info "Feature list: $feature_list"
+    if [[ -n "$features_filter" ]]; then
+        log_info "Features filter: $features_filter"
+    fi
     log_info "Max retries per feature: $MAX_RETRIES"
     if [[ $SESSION_TIMEOUT -gt 0 ]]; then
         log_info "Session timeout: ${SESSION_TIMEOUT}s"
@@ -889,11 +893,17 @@ for f in data.get('stuck_features', []):
 
         # Find next feature to process
         local next_feature
+        local _get_next_args=(
+            --feature-list "$feature_list"
+            --state-dir "$STATE_DIR"
+            --max-retries "$MAX_RETRIES"
+            --action get_next
+        )
+        if [[ -n "$features_filter" ]]; then
+            _get_next_args+=(--features "$features_filter")
+        fi
         next_feature=$(python3 "$SCRIPTS_DIR/update-feature-status.py" \
-            --feature-list "$feature_list" \
-            --state-dir "$STATE_DIR" \
-            --max-retries "$MAX_RETRIES" \
-            --action get_next 2>/dev/null) || true
+            "${_get_next_args[@]}" 2>/dev/null) || true
 
         if [[ "$next_feature" == "PIPELINE_COMPLETE" ]]; then
             echo ""
@@ -1060,13 +1070,18 @@ show_help() {
     echo "Usage: $0 <command> [options]"
     echo ""
     echo "Commands:"
-    echo "  run [feature-list.json]                 Run all features sequentially"
+    echo "  run [feature-list.json] [--features <filter>]  Run features (all or filtered subset)"
     echo "  run <feature-id> [options]              Run a single feature"
     echo "  status [feature-list.json]               Show pipeline status"
     echo "  test-cli                                 Test AI CLI: show detected CLI, version, and model"
     echo "  reset                                    Clear all state and start fresh"
     echo "  help                                     Show this help message"
     echo ""
+    echo "Feature Filter (--features):"
+    echo "  --features F-001,F-003,F-005             Run only specified features"
+    echo "  --features F-001:F-010                   Run a range of features (F-001 through F-010)"
+    echo "  --features F-001,F-005:F-010             Mixed: individual IDs + ranges"
+    echo ""
     echo "Single Feature Options (run <feature-id>):"
     echo "  --dry-run                   Generate bootstrap prompt only, don't spawn session"
     echo "  --resume-phase N            Override resume phase (default: auto-detect)"
@@ -1089,6 +1104,8 @@ show_help() {
     echo ""
     echo "Examples:"
     echo "  ./run.sh run                                         # Run all features"
+    echo "  ./run.sh run --features F-001,F-003,F-005             # Run specific features"
+    echo "  ./run.sh run --features F-001:F-010                   # Run features F-001 through F-010"
     echo "  ./run.sh run F-007 --dry-run                          # Inspect generated prompt"
     echo "  ./run.sh run F-007 --dry-run --mode lite               # Test lite mode"
     echo "  ./run.sh run F-007 --resume-phase 6                    # Skip to implementation"
@@ -1107,7 +1124,27 @@ case "${1:-run}" in
         if [[ "${1:-}" =~ ^[Ff]-[0-9]+ ]]; then
             run_one "$@"
         else
-            main "${1:-feature-list.json}"
+            # Parse positional and --features flag
+            local _run_feature_list="feature-list.json"
+            local _run_features_filter=""
+            while [[ $# -gt 0 ]]; do
+                case "$1" in
+                    --features)
+                        shift
+                        if [[ $# -eq 0 ]]; then
+                            log_error "--features requires a value (e.g. --features F-001,F-003 or --features F-001:F-010)"
+                            exit 1
+                        fi
+                        _run_features_filter="$1"
+                        shift
+                        ;;
+                    *)
+                        _run_feature_list="$1"
+                        shift
+                        ;;
+                esac
+            done
+            main "$_run_feature_list" "$_run_features_filter"
         fi
         ;;
     status)

package/bundled/dev-pipeline/scripts/update-feature-status.py

@@ -16,7 +16,8 @@ Usage:
         --feature-list <path> --state-dir <path> \
         --action <get_next|start|update|status|pause|reset|clean|complete> \
         [--feature-id <id>] [--session-status <status>] \
-        [--session-id <id>] [--max-retries <n>]
+        [--session-id <id>] [--max-retries <n>] \
+        [--features <filter>]
 """
 
 import argparse
@@ -102,9 +103,49 @@ def parse_args():
         default=None,
         help="Project root directory. Required for 'clean' action.",
     )
+    parser.add_argument(
+        "--features",
+        default=None,
+        help="Feature filter: comma-separated IDs (F-001,F-003) or range (F-001:F-010), or mixed.",
+    )
     return parser.parse_args()
 
 
+def parse_feature_filter(features_str):
+    """Parse --features argument into a set of feature IDs.
+
+    Supported formats:
+      F-001,F-003,F-005   -> {"F-001", "F-003", "F-005"}
+      F-001:F-010          -> {"F-001", "F-002", ..., "F-010"}
+      F-001,F-005:F-010    -> mixed, union of both
+
+    Returns None if features_str is None/empty (meaning no filter).
+    """
+    if not features_str:
+        return None
+
+    result = set()
+    for part in features_str.split(","):
+        part = part.strip()
+        if not part:
+            continue
+        if ":" in part:
+            tokens = part.split(":", 1)
+            m_start = re.search(r"\d+", tokens[0])
+            m_end = re.search(r"\d+", tokens[1])
+            if not m_start or not m_end:
+                error_out("Invalid range format: {}".format(part))
+            start_num = int(m_start.group())
+            end_num = int(m_end.group())
+            if start_num > end_num:
+                start_num, end_num = end_num, start_num
+            for i in range(start_num, end_num + 1):
+                result.add("F-{:03d}".format(i))
+        else:
+            result.add(part.upper())
+    return result if result else None
+
+
 def now_iso():
     """Return the current UTC time in ISO8601 format."""
     return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
@@ -285,20 +326,31 @@ def load_session_status(state_dir, feature_id, session_id):
 # Action: get_next
 # ---------------------------------------------------------------------------
 
-def action_get_next(feature_list_data, state_dir):
+def action_get_next(feature_list_data, state_dir, feature_filter=None):
     """Find the next feature to process.
 
     Priority logic:
     1. Skip terminal statuses (completed, failed, skipped)
-    2. Check that all dependencies are completed
-    3. Prefer in_progress features over pending ones (interrupted session resume)
-    4. Among eligible features, pick lowest priority number (highest priority)
+    2. If feature_filter is set, skip features not in the filter
+    3. Check that all dependencies are completed
+    4. Prefer in_progress features over pending ones (interrupted session resume)
+    5. Among eligible features, pick lowest priority number (highest priority)
     """
     features = feature_list_data.get("features", [])
     if not features:
         print("PIPELINE_COMPLETE")
         return
 
+    # Apply feature filter: only consider features in the whitelist
+    if feature_filter is not None:
+        features = [
+            f for f in features
+            if isinstance(f, dict) and f.get("id") in feature_filter
+        ]
+        if not features:
+            print("PIPELINE_COMPLETE")
+            return
+
     # Build a map of feature statuses from state dir
     status_map = {}  # feature_id -> status string
     status_data_map = {}  # feature_id -> full status data
@@ -678,7 +730,7 @@ def _estimate_remaining_time(features, state_dir, counts, feature_list_data=None
     return remaining_seconds, confidence
 
 
-def action_status(feature_list_data, state_dir):
+def action_status(feature_list_data, state_dir, feature_filter=None):
     """Print a formatted overview of all features and their status.
 
     Status is read exclusively from feature-list.json (the single source of
@@ -688,6 +740,13 @@ def action_status(feature_list_data, state_dir):
     features = feature_list_data.get("features", [])
     app_name = feature_list_data.get("app_name", "Unknown")
 
+    # Apply feature filter
+    if feature_filter is not None:
+        features = [
+            f for f in features
+            if isinstance(f, dict) and f.get("id") in feature_filter
+        ]
+
     # Gather status info
     counts = {
         "completed": 0,
@@ -1080,15 +1139,18 @@ def main():
     if err:
         error_out("Cannot load feature list: {}".format(err))
 
+    # Parse feature filter (used by get_next and status)
+    feature_filter = parse_feature_filter(args.features)
+
     # Dispatch action
     if args.action == "get_next":
-        action_get_next(feature_list_data, args.state_dir)
+        action_get_next(feature_list_data, args.state_dir, feature_filter)
     elif args.action == "start":
         action_start(args, args.feature_list, args.state_dir)
     elif args.action == "update":
         action_update(args, args.feature_list, args.state_dir)
     elif args.action == "status":
-        action_status(feature_list_data, args.state_dir)
+        action_status(feature_list_data, args.state_dir, feature_filter)
     elif args.action == "reset":
         action_reset(args, args.feature_list, args.state_dir)
     elif args.action == "clean":

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.100",
+  "version": "1.0.102",
   "skills": {
     "prizm-kit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",

package/bundled/skills/app-planner/SKILL.md

@@ -75,12 +75,31 @@ Actions:
 3. Append features with next sequential `F-NNN` IDs
 4. Preserve style/language/detail consistency with existing plan
 
+## Intent Confirmation (Mandatory First Step)
+
+After scenario routing, immediately confirm the user's deliverable intent:
+
+1. **Ask explicitly**:
+   - "本次规划的目标是生成可执行的 `feature-list.json` 吗？还是只想先讨论想法？"
+   - (English: "Is the goal to produce a `feature-list.json` for pipeline execution, or just explore ideas?")
+
+2. **Route by answer**:
+   - **"Produce feature-list.json"** → Continue to Core Workflow. Set session goal = `produce`.
+   - **"Just explore ideas"** → Enter **Exploration Mode**:
+     - Run Phases 1-5 normally (vision, constraints, feature proposals, refinement, DAG)
+     - At Phase 5 completion, re-ask: "Ideas are taking shape. Ready to generate `feature-list.json` now?"
+     - If yes → continue to Phase 6
+     - If no → summarize discussion, suggest saving notes, end session
+
+3. **Session goal tracking**: Track the intent (`produce` or `explore`) throughout the session. If `explore`, always re-prompt before ending.
+
 ## Core Workflow
 
 Execute the selected scenario workflow in conversation mode with mandatory checkpoints:
 
 ### Interactive Phases
 1. clarify business goal and scope
+   1.1 confirm deliverable intent (→ Intent Confirmation)
 2. confirm constraints and tech assumptions
 3. propose feature set with dependencies
 4. refine descriptions and acceptance criteria
@@ -95,6 +114,7 @@ Checkpoints catch cascading errors early — skipping one means the next phase b
 
 | Checkpoint | Artifact/State | Criteria | Phase |
 |-----------|----------------|----------|-------|
+| **CP-AP-0** | Intent Confirmed | User confirmed session goal (produce / explore) | 1 |
 | **CP-AP-1** | Vision Summary | Goal/users/differentiators confirmed by user | 1-2 |
 | **CP-AP-2** | Feature Proposals | Feature set with titles+deps identified (pre-validation) | 3-5 |
 | **CP-AP-3** | DAG Validity | No cycles, dependencies resolved (validation dry-run) | 6 |
@@ -331,6 +351,29 @@ The pipeline reads `feature-list.json` from the project root by default. If the
 
 Maintainer note: evaluation workflow moved to `assets/evaluation-guide.md`.
 
+## Session Exit Gate
+
+Prevent accidental session exit without deliverable completion.
+
+### Trigger Conditions
+
+Activate exit gate when ALL of these are true:
+- Session goal = `produce` (user confirmed they want feature-list.json via CP-AP-0)
+- Current phase < Phase 7 (final validation not yet passed)
+- No valid `feature-list.json` has been written in this session
+
+### Gate Behavior
+
+When the session appears to be ending (user says "thanks", "that's all", "bye", or conversation goes idle after Phase 3+):
+
+1. **Remind**: "You set out to produce `feature-list.json` but we haven't completed it yet."
+2. **Offer 3 options**:
+   - **(a) Continue to completion** — resume from current phase
+   - **(b) Abandon** — confirm user explicitly wants to exit without output
+3. **If (b) Save draft**: Write the draft file and remind user: "This is a draft, not validated. Run `/app-planner` again to resume and finalize."
+4. **If (c) Abandon**: Accept without further prompting.
+
+
 ## Handoff Message Template
 
 After successful validation, report:

package/bundled/skills/dev-pipeline-launcher/SKILL.md

@@ -28,6 +28,7 @@ Use daemon mode (`launch-daemon.sh`) only when:
 - "launch pipeline", "start implementing", "run the pipeline", "start auto-development"
 - "implement next steps", "execute feature list", "start building"
 - After app-planner completes: "build it", "start developing from the feature list"
+- "run only F-001 to F-005", "run features F-001,F-003", "only build these features"
 
 **Check status** -- User says:
 - "pipeline status", "check pipeline", "how's it going", "progress"
@@ -117,11 +118,20 @@ Detect user intent from their message, then follow the corresponding workflow:
    ```bash
    dev-pipeline/run.sh run feature-list.json
    ```
+   If user wants to run only specific features:
+   ```bash
+   dev-pipeline/run.sh run feature-list.json --features F-001:F-005
+   dev-pipeline/run.sh run feature-list.json --features F-001,F-003,F-007
+   ```
 
    **If option 2 (background)**:
    ```bash
    dev-pipeline/launch-daemon.sh start feature-list.json
    ```
+   With feature filter:
+   ```bash
+   dev-pipeline/launch-daemon.sh start feature-list.json --features F-001:F-005
+   ```
    Note: Pipeline runs fully detached. Survives session closure.
 
    **If option 3 (manual)**: Print commands and stop. Do not execute anything.
@@ -251,7 +261,35 @@ dev-pipeline/launch-daemon.sh start feature-list.json --env "SESSION_TIMEOUT=720
 
 ---
 
-#### Intent F: Retry Single Feature Node
+#### Intent F: Run Subset of Features
+
+When user says "run only F-001 to F-005", "only build features 1 through 5":
+
+```bash
+dev-pipeline/run.sh run feature-list.json --features F-001:F-005
+```
+
+When user says "run F-001, F-003, and F-007", "only build these three features":
+
+```bash
+dev-pipeline/run.sh run feature-list.json --features F-001,F-003,F-007
+```
+
+Mixed format (IDs + ranges):
+
+```bash
+dev-pipeline/run.sh run feature-list.json --features F-001,F-005:F-010
+```
+
+Background daemon with feature filter:
+
+```bash
+dev-pipeline/launch-daemon.sh start feature-list.json --features F-001:F-005
+```
+
+---
+
+#### Intent G: Retry Single Feature Node
 
 When user says "retry F-003":
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.0.100",
+  "version": "1.0.102",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {

package/src/gitignore-template.js

@@ -17,9 +17,6 @@ export function generateGitignore(options = {}) {
     '# Prizm 文档（按需决定是否提交）',
     '# .prizm-docs/',
     '',
-    '# PrizmKit 工作流制品',
-    '.prizmkit/',
-    '',
   ];
 
   if (options.pipeline) {

package/src/scaffold.js

@@ -655,18 +655,8 @@ export async function installGitignore(projectRoot, options, dryRun) {
   }
 
   if (await fs.pathExists(targetPath)) {
-    const existing = await fs.readFile(targetPath, 'utf8');
-
-    // If .prizmkit/ is already ignored, nothing to do
-    if (existing.includes('.prizmkit/')) {
-      console.log(chalk.yellow(`      ⚠ .gitignore 已包含 .prizmkit/ 条目，跳过`));
-      return;
-    }
-
-    // No PrizmKit entries at all — append full .prizmkit/ block
-    const prizmkitSection = '\n\n# PrizmKit\n.prizmkit/\n';
-    await fs.appendFile(targetPath, prizmkitSection);
-    console.log(chalk.green(`      ✓ .gitignore (追加 PrizmKit 条目)`));
+    console.log(chalk.yellow(`      ⚠ .gitignore 已存在，跳过`));
+    return;
   } else {
     const content = generateGitignore({ pipeline: options.pipeline });
     await fs.writeFile(targetPath, content);