sddflow 2.7.91__tar.gz → 2.7.92__tar.gz

{sddflow-2.7.91 → sddflow-2.7.92}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sddflow
-Version: 2.7.91
+Version: 2.7.92
 Summary: SDD Framework CLI — initialize and upgrade Spec-Driven Development packs
 Project-URL: Homepage, https://github.com/sunil1983us/universalguide
 Project-URL: Repository, https://github.com/sunil1983us/universalguide

{sddflow-2.7.91 → sddflow-2.7.92}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sddflow"
-version = "2.7.91"
+version = "2.7.92"
 description = "SDD Framework CLI — initialize and upgrade Spec-Driven Development packs"
 readme = "README.md"
 requires-python = ">=3.9"

sddflow-2.7.92/sdd/__init__.py

@@ -0,0 +1 @@
+__version__ = "2.7.92"

{sddflow-2.7.91 → sddflow-2.7.92}/sdd/commands/upgrade.py

@@ -3696,6 +3696,47 @@ MIGRATIONS = [
         ],
         "migrate": lambda m: {**m, "sdd_version": "2.7.91"},
     },
+    {
+        "from":        "2.7.91",
+        "to":          "2.7.92",
+        "description": "setup.sh/setup.ps1 now interactively ask for reading_mode (auto|summary|full) instead of silently baking in the 'auto' default with no prompt",
+        "notes": [
+            "A user asked directly: reading_mode already existed as a "
+            "documented manifest.yml field (AI-2 token-economy switch in "
+            "summary-rules.md), but grepping setup.sh/setup.ps1 confirmed "
+            "it was never part of the interactive flow -- only name, "
+            "scope, feature, and plan_mode were ever asked. Every new "
+            "project silently got 'auto' with no chance to pick summary "
+            "or full at init time",
+            "Added a --reading-mode flag (-ReadingMode in PowerShell) and "
+            "an interactive prompt with the same three-option explanation "
+            "already in summary-rules.md, mirroring the existing plan_mode "
+            "prompt pattern exactly -- same env-var-safe substitution in "
+            "sdd-universal/setup.sh (project/feature names can contain "
+            "special characters), same regex substitution in the shared "
+            "_shared/full/setup.sh used by the other 4 non-micro packs",
+            "sdd-micro intentionally excluded -- confirmed via grep it has "
+            "no reading_mode field in its manifest.yml at all (no "
+            "BRD/UC/SRD documents to summarize, so the AI-2 token-economy "
+            "switch doesn't apply there)",
+            "Verified with a real pty (not piped stdin, which forces "
+            "non-interactive mode by the script's own design and would've "
+            "given a false pass): the prompt renders, accepts 'summary', "
+            "and writes reading_mode: \"summary\" into manifest.yml. Also "
+            "verified --reading-mode full/summary flags directly on "
+            "sdd-backend-service, sdd-frontend-spa, and sdd-universal's "
+            "separate setup.sh",
+            "This Node CLI ships from the same pack sources -- this "
+            "migration entry exists so both CLIs report the same "
+            "sdd_version chain",
+            "No manifest.yml schema change for existing projects -- the "
+            "field already existed, only new-project setup behavior "
+            "changed. Verified: cli-python pytest 688/688 (unaffected), "
+            "test-setup.sh 15/15, test-setup-micro.sh 12/12, "
+            "assert-output.sh clean on both worked examples",
+        ],
+        "migrate": lambda m: {**m, "sdd_version": "2.7.92"},
+    },
 ]
 
 

{sddflow-2.7.91 → sddflow-2.7.92}/sdd/packs/sdd-backend-service/.specify/manifest.yml

@@ -43,5 +43,5 @@ testing_style: "paired"
 # If using sdd-universal instead, set project_type: "backend-service" in its manifest.yml
 # project_type: "backend-service"
 
-sdd_version: "2.7.91"   # set by sdd init; used by sdd upgrade
+sdd_version: "2.7.92"   # set by sdd init; used by sdd upgrade
 ai_tool: ""             # set by sdd init: claude-code | copilot | cursor | windsurf | other

{sddflow-2.7.91/sdd/packs/sdd-frontend-spa → sddflow-2.7.92/sdd/packs/sdd-backend-service}/setup.ps1

@@ -1,12 +1,13 @@
 # SDD Framework — Project Initializer (PowerShell)
-# Usage: .\setup.ps1 [-Project <name>] [-Scope pilot|mvp|full] [-Feature <name>] [-PlanMode unified|separate]
+# Usage: .\setup.ps1 [-Project <name>] [-Scope pilot|mvp|full] [-Feature <name>] [-PlanMode unified|separate] [-ReadingMode auto|summary|full]
 # Run this once after copying the pack into your project directory.
 
 param(
-  [string]$Project  = "",
-  [string]$Scope    = "",
-  [string]$Feature  = "",
-  [string]$PlanMode = ""
+  [string]$Project     = "",
+  [string]$Scope       = "",
+  [string]$Feature     = "",
+  [string]$PlanMode    = "",
+  [string]$ReadingMode = ""
 )
 
 Write-Host ""
@@ -60,12 +61,31 @@ if (-not $PlanMode) {
   }
 }
 
+if (-not $ReadingMode) {
+  if ($Interactive) {
+    Write-Host ""
+    Write-Host "Document reading mode (token economy — see summary-rules.md):"
+    Write-Host "  auto    — use each doc's .summary.md when present, fall back to the"
+    Write-Host "            full document (and generate a summary) when it's missing."
+    Write-Host "            Good for: almost everyone — self-heals, never stuck."
+    Write-Host "  summary — always use .summary.md; warns instead of reading the full"
+    Write-Host "            doc if one is missing. Good for: strict token budgets."
+    Write-Host "  full    — always read the full document, every command. Good for:"
+    Write-Host "            deep debugging, or migrating a project with no summaries."
+    $ReadingModeInput = Read-Host "Reading mode [auto]"
+    $ReadingMode = if ($ReadingModeInput) { $ReadingModeInput } else { "auto" }
+  } else {
+    $ReadingMode = "auto"
+  }
+}
+
 Write-Host ""
 Write-Host "Setting up:"
-Write-Host "  Project   : $Project"
-Write-Host "  Feature   : $Feature"
-Write-Host "  Scope     : $Scope"
-Write-Host "  Plan mode : $PlanMode"
+Write-Host "  Project      : $Project"
+Write-Host "  Feature      : $Feature"
+Write-Host "  Scope        : $Scope"
+Write-Host "  Plan mode    : $PlanMode"
+Write-Host "  Reading mode : $ReadingMode"
 Write-Host ""
 
 # --- Update manifest.yml ---
@@ -77,6 +97,7 @@ if (Test-Path $ManifestPath) {
   $content = $content -replace 'feature:\s*""',             "feature: `"$Feature`""
   $content = $content -replace 'context_file:\s*""',        "context_file: `"$Feature.md`""
   $content = $content -replace 'plan_mode:\s*"unified"',    "plan_mode: `"$PlanMode`""
+  $content = $content -replace 'reading_mode:\s*"auto"',    "reading_mode: `"$ReadingMode`""
   Set-Content $ManifestPath $content
   Write-Host "  [OK]  .specify\manifest.yml filled"
 } else {

{sddflow-2.7.91/sdd/packs/sdd-fullstack → sddflow-2.7.92/sdd/packs/sdd-backend-service}/setup.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # SDD Framework — Project Initializer
-# Usage: bash setup.sh [--project <name>] [--scope pilot|mvp|full] [--feature <name>] [--plan-mode unified|separate]
+# Usage: bash setup.sh [--project <name>] [--scope pilot|mvp|full] [--feature <name>] [--plan-mode unified|separate] [--reading-mode auto|summary|full]
 # Run this once after copying the pack into your project directory.
 
 set -euo pipefail
@@ -17,13 +17,15 @@ SCOPE=""
 FEATURE_NAME=""
 
 PLAN_MODE=""
+READING_MODE=""
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    --project)    PROJECT_NAME="$2"; shift 2;;
-    --scope)      SCOPE="$2";        shift 2;;
-    --feature)    FEATURE_NAME="$2"; shift 2;;
-    --plan-mode)  PLAN_MODE="$2";    shift 2;;
+    --project)      PROJECT_NAME="$2"; shift 2;;
+    --scope)        SCOPE="$2";        shift 2;;
+    --feature)      FEATURE_NAME="$2"; shift 2;;
+    --plan-mode)    PLAN_MODE="$2";    shift 2;;
+    --reading-mode) READING_MODE="$2"; shift 2;;
     *) echo "Unknown option: $1"; exit 1;;
   esac
 done
@@ -81,12 +83,29 @@ if [[ -z "$PLAN_MODE" ]]; then
   PLAN_MODE="${PLAN_MODE:-unified}"
 fi
 
+if [[ -z "$READING_MODE" ]]; then
+  if [[ $INTERACTIVE -eq 1 ]]; then
+    echo ""
+    echo "Document reading mode (token economy — see summary-rules.md):"
+    echo "  auto    — use each doc's .summary.md when present, fall back to the"
+    echo "            full document (and generate a summary) when it's missing."
+    echo "            Good for: almost everyone — self-heals, never stuck."
+    echo "  summary — always use .summary.md; warns instead of reading the full"
+    echo "            doc if one is missing. Good for: strict token budgets."
+    echo "  full    — always read the full document, every command. Good for:"
+    echo "            deep debugging, or migrating a project with no summaries."
+    read -r -p "Reading mode [auto]: " READING_MODE
+  fi
+  READING_MODE="${READING_MODE:-auto}"
+fi
+
 echo ""
 echo "Setting up:"
-echo "  Project   : $PROJECT_NAME"
-echo "  Feature   : $FEATURE_NAME"
-echo "  Scope     : $SCOPE"
-echo "  Plan mode : $PLAN_MODE"
+echo "  Project      : $PROJECT_NAME"
+echo "  Feature      : $FEATURE_NAME"
+echo "  Scope        : $SCOPE"
+echo "  Plan mode    : $PLAN_MODE"
+echo "  Reading mode : $READING_MODE"
 echo ""
 
 # --- Update manifest.yml ---
@@ -102,6 +121,7 @@ content = re.sub(r'scope:\s*"pilot"', 'scope: "$SCOPE"', content)
 content = re.sub(r'feature:\s*""', 'feature: "$FEATURE_NAME"', content)
 content = re.sub(r'context_file:\s*""', 'context_file: "$FEATURE_NAME.md"', content)
 content = re.sub(r'plan_mode:\s*"unified"', 'plan_mode: "$PLAN_MODE"', content)
+content = re.sub(r'reading_mode:\s*"auto"', 'reading_mode: "$READING_MODE"', content)
 with open("$MANIFEST", "w") as f:
     f.write(content)
 PYEOF

{sddflow-2.7.91 → sddflow-2.7.92}/sdd/packs/sdd-frontend-spa/.specify/manifest.yml

@@ -32,5 +32,5 @@ testing_style: "paired"
 # If using sdd-universal instead, set project_type: "frontend-spa" in its manifest.yml
 # project_type: "frontend-spa"
 
-sdd_version: "2.7.91"   # set by sdd init; used by sdd upgrade
+sdd_version: "2.7.92"   # set by sdd init; used by sdd upgrade
 ai_tool: ""             # set by sdd init: claude-code | copilot | cursor | windsurf | other

{sddflow-2.7.91/sdd/packs/sdd-fullstack → sddflow-2.7.92/sdd/packs/sdd-frontend-spa}/setup.ps1

@@ -1,12 +1,13 @@
 # SDD Framework — Project Initializer (PowerShell)
-# Usage: .\setup.ps1 [-Project <name>] [-Scope pilot|mvp|full] [-Feature <name>] [-PlanMode unified|separate]
+# Usage: .\setup.ps1 [-Project <name>] [-Scope pilot|mvp|full] [-Feature <name>] [-PlanMode unified|separate] [-ReadingMode auto|summary|full]
 # Run this once after copying the pack into your project directory.
 
 param(
-  [string]$Project  = "",
-  [string]$Scope    = "",
-  [string]$Feature  = "",
-  [string]$PlanMode = ""
+  [string]$Project     = "",
+  [string]$Scope       = "",
+  [string]$Feature     = "",
+  [string]$PlanMode    = "",
+  [string]$ReadingMode = ""
 )
 
 Write-Host ""
@@ -60,12 +61,31 @@ if (-not $PlanMode) {
   }
 }
 
+if (-not $ReadingMode) {
+  if ($Interactive) {
+    Write-Host ""
+    Write-Host "Document reading mode (token economy — see summary-rules.md):"
+    Write-Host "  auto    — use each doc's .summary.md when present, fall back to the"
+    Write-Host "            full document (and generate a summary) when it's missing."
+    Write-Host "            Good for: almost everyone — self-heals, never stuck."
+    Write-Host "  summary — always use .summary.md; warns instead of reading the full"
+    Write-Host "            doc if one is missing. Good for: strict token budgets."
+    Write-Host "  full    — always read the full document, every command. Good for:"
+    Write-Host "            deep debugging, or migrating a project with no summaries."
+    $ReadingModeInput = Read-Host "Reading mode [auto]"
+    $ReadingMode = if ($ReadingModeInput) { $ReadingModeInput } else { "auto" }
+  } else {
+    $ReadingMode = "auto"
+  }
+}
+
 Write-Host ""
 Write-Host "Setting up:"
-Write-Host "  Project   : $Project"
-Write-Host "  Feature   : $Feature"
-Write-Host "  Scope     : $Scope"
-Write-Host "  Plan mode : $PlanMode"
+Write-Host "  Project      : $Project"
+Write-Host "  Feature      : $Feature"
+Write-Host "  Scope        : $Scope"
+Write-Host "  Plan mode    : $PlanMode"
+Write-Host "  Reading mode : $ReadingMode"
 Write-Host ""
 
 # --- Update manifest.yml ---
@@ -77,6 +97,7 @@ if (Test-Path $ManifestPath) {
   $content = $content -replace 'feature:\s*""',             "feature: `"$Feature`""
   $content = $content -replace 'context_file:\s*""',        "context_file: `"$Feature.md`""
   $content = $content -replace 'plan_mode:\s*"unified"',    "plan_mode: `"$PlanMode`""
+  $content = $content -replace 'reading_mode:\s*"auto"',    "reading_mode: `"$ReadingMode`""
   Set-Content $ManifestPath $content
   Write-Host "  [OK]  .specify\manifest.yml filled"
 } else {

{sddflow-2.7.91 → sddflow-2.7.92}/sdd/packs/sdd-frontend-spa/setup.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # SDD Framework — Project Initializer
-# Usage: bash setup.sh [--project <name>] [--scope pilot|mvp|full] [--feature <name>] [--plan-mode unified|separate]
+# Usage: bash setup.sh [--project <name>] [--scope pilot|mvp|full] [--feature <name>] [--plan-mode unified|separate] [--reading-mode auto|summary|full]
 # Run this once after copying the pack into your project directory.
 
 set -euo pipefail
@@ -17,13 +17,15 @@ SCOPE=""
 FEATURE_NAME=""
 
 PLAN_MODE=""
+READING_MODE=""
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    --project)    PROJECT_NAME="$2"; shift 2;;
-    --scope)      SCOPE="$2";        shift 2;;
-    --feature)    FEATURE_NAME="$2"; shift 2;;
-    --plan-mode)  PLAN_MODE="$2";    shift 2;;
+    --project)      PROJECT_NAME="$2"; shift 2;;
+    --scope)        SCOPE="$2";        shift 2;;
+    --feature)      FEATURE_NAME="$2"; shift 2;;
+    --plan-mode)    PLAN_MODE="$2";    shift 2;;
+    --reading-mode) READING_MODE="$2"; shift 2;;
     *) echo "Unknown option: $1"; exit 1;;
   esac
 done
@@ -81,12 +83,29 @@ if [[ -z "$PLAN_MODE" ]]; then
   PLAN_MODE="${PLAN_MODE:-unified}"
 fi
 
+if [[ -z "$READING_MODE" ]]; then
+  if [[ $INTERACTIVE -eq 1 ]]; then
+    echo ""
+    echo "Document reading mode (token economy — see summary-rules.md):"
+    echo "  auto    — use each doc's .summary.md when present, fall back to the"
+    echo "            full document (and generate a summary) when it's missing."
+    echo "            Good for: almost everyone — self-heals, never stuck."
+    echo "  summary — always use .summary.md; warns instead of reading the full"
+    echo "            doc if one is missing. Good for: strict token budgets."
+    echo "  full    — always read the full document, every command. Good for:"
+    echo "            deep debugging, or migrating a project with no summaries."
+    read -r -p "Reading mode [auto]: " READING_MODE
+  fi
+  READING_MODE="${READING_MODE:-auto}"
+fi
+
 echo ""
 echo "Setting up:"
-echo "  Project   : $PROJECT_NAME"
-echo "  Feature   : $FEATURE_NAME"
-echo "  Scope     : $SCOPE"
-echo "  Plan mode : $PLAN_MODE"
+echo "  Project      : $PROJECT_NAME"
+echo "  Feature      : $FEATURE_NAME"
+echo "  Scope        : $SCOPE"
+echo "  Plan mode    : $PLAN_MODE"
+echo "  Reading mode : $READING_MODE"
 echo ""
 
 # --- Update manifest.yml ---
@@ -102,6 +121,7 @@ content = re.sub(r'scope:\s*"pilot"', 'scope: "$SCOPE"', content)
 content = re.sub(r'feature:\s*""', 'feature: "$FEATURE_NAME"', content)
 content = re.sub(r'context_file:\s*""', 'context_file: "$FEATURE_NAME.md"', content)
 content = re.sub(r'plan_mode:\s*"unified"', 'plan_mode: "$PLAN_MODE"', content)
+content = re.sub(r'reading_mode:\s*"auto"', 'reading_mode: "$READING_MODE"', content)
 with open("$MANIFEST", "w") as f:
     f.write(content)
 PYEOF

{sddflow-2.7.91 → sddflow-2.7.92}/sdd/packs/sdd-fullstack/.specify/manifest.yml

@@ -32,5 +32,5 @@ testing_style: "paired"
 # If using sdd-universal instead, set project_type: "fullstack" in its manifest.yml
 # project_type: "fullstack"
 
-sdd_version: "2.7.91"   # set by sdd init; used by sdd upgrade
+sdd_version: "2.7.92"   # set by sdd init; used by sdd upgrade
 ai_tool: ""             # set by sdd init: claude-code | copilot | cursor | windsurf | other

{sddflow-2.7.91/sdd/packs/sdd-mobile → sddflow-2.7.92/sdd/packs/sdd-fullstack}/setup.ps1

@@ -1,12 +1,13 @@
 # SDD Framework — Project Initializer (PowerShell)
-# Usage: .\setup.ps1 [-Project <name>] [-Scope pilot|mvp|full] [-Feature <name>] [-PlanMode unified|separate]
+# Usage: .\setup.ps1 [-Project <name>] [-Scope pilot|mvp|full] [-Feature <name>] [-PlanMode unified|separate] [-ReadingMode auto|summary|full]
 # Run this once after copying the pack into your project directory.
 
 param(
-  [string]$Project  = "",
-  [string]$Scope    = "",
-  [string]$Feature  = "",
-  [string]$PlanMode = ""
+  [string]$Project     = "",
+  [string]$Scope       = "",
+  [string]$Feature     = "",
+  [string]$PlanMode    = "",
+  [string]$ReadingMode = ""
 )
 
 Write-Host ""
@@ -60,12 +61,31 @@ if (-not $PlanMode) {
   }
 }
 
+if (-not $ReadingMode) {
+  if ($Interactive) {
+    Write-Host ""
+    Write-Host "Document reading mode (token economy — see summary-rules.md):"
+    Write-Host "  auto    — use each doc's .summary.md when present, fall back to the"
+    Write-Host "            full document (and generate a summary) when it's missing."
+    Write-Host "            Good for: almost everyone — self-heals, never stuck."
+    Write-Host "  summary — always use .summary.md; warns instead of reading the full"
+    Write-Host "            doc if one is missing. Good for: strict token budgets."
+    Write-Host "  full    — always read the full document, every command. Good for:"
+    Write-Host "            deep debugging, or migrating a project with no summaries."
+    $ReadingModeInput = Read-Host "Reading mode [auto]"
+    $ReadingMode = if ($ReadingModeInput) { $ReadingModeInput } else { "auto" }
+  } else {
+    $ReadingMode = "auto"
+  }
+}
+
 Write-Host ""
 Write-Host "Setting up:"
-Write-Host "  Project   : $Project"
-Write-Host "  Feature   : $Feature"
-Write-Host "  Scope     : $Scope"
-Write-Host "  Plan mode : $PlanMode"
+Write-Host "  Project      : $Project"
+Write-Host "  Feature      : $Feature"
+Write-Host "  Scope        : $Scope"
+Write-Host "  Plan mode    : $PlanMode"
+Write-Host "  Reading mode : $ReadingMode"
 Write-Host ""
 
 # --- Update manifest.yml ---
@@ -77,6 +97,7 @@ if (Test-Path $ManifestPath) {
   $content = $content -replace 'feature:\s*""',             "feature: `"$Feature`""
   $content = $content -replace 'context_file:\s*""',        "context_file: `"$Feature.md`""
   $content = $content -replace 'plan_mode:\s*"unified"',    "plan_mode: `"$PlanMode`""
+  $content = $content -replace 'reading_mode:\s*"auto"',    "reading_mode: `"$ReadingMode`""
   Set-Content $ManifestPath $content
   Write-Host "  [OK]  .specify\manifest.yml filled"
 } else {

{sddflow-2.7.91/sdd/packs/sdd-mobile → sddflow-2.7.92/sdd/packs/sdd-fullstack}/setup.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # SDD Framework — Project Initializer
-# Usage: bash setup.sh [--project <name>] [--scope pilot|mvp|full] [--feature <name>] [--plan-mode unified|separate]
+# Usage: bash setup.sh [--project <name>] [--scope pilot|mvp|full] [--feature <name>] [--plan-mode unified|separate] [--reading-mode auto|summary|full]
 # Run this once after copying the pack into your project directory.
 
 set -euo pipefail
@@ -17,13 +17,15 @@ SCOPE=""
 FEATURE_NAME=""
 
 PLAN_MODE=""
+READING_MODE=""
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    --project)    PROJECT_NAME="$2"; shift 2;;
-    --scope)      SCOPE="$2";        shift 2;;
-    --feature)    FEATURE_NAME="$2"; shift 2;;
-    --plan-mode)  PLAN_MODE="$2";    shift 2;;
+    --project)      PROJECT_NAME="$2"; shift 2;;
+    --scope)        SCOPE="$2";        shift 2;;
+    --feature)      FEATURE_NAME="$2"; shift 2;;
+    --plan-mode)    PLAN_MODE="$2";    shift 2;;
+    --reading-mode) READING_MODE="$2"; shift 2;;
     *) echo "Unknown option: $1"; exit 1;;
   esac
 done
@@ -81,12 +83,29 @@ if [[ -z "$PLAN_MODE" ]]; then
   PLAN_MODE="${PLAN_MODE:-unified}"
 fi
 
+if [[ -z "$READING_MODE" ]]; then
+  if [[ $INTERACTIVE -eq 1 ]]; then
+    echo ""
+    echo "Document reading mode (token economy — see summary-rules.md):"
+    echo "  auto    — use each doc's .summary.md when present, fall back to the"
+    echo "            full document (and generate a summary) when it's missing."
+    echo "            Good for: almost everyone — self-heals, never stuck."
+    echo "  summary — always use .summary.md; warns instead of reading the full"
+    echo "            doc if one is missing. Good for: strict token budgets."
+    echo "  full    — always read the full document, every command. Good for:"
+    echo "            deep debugging, or migrating a project with no summaries."
+    read -r -p "Reading mode [auto]: " READING_MODE
+  fi
+  READING_MODE="${READING_MODE:-auto}"
+fi
+
 echo ""
 echo "Setting up:"
-echo "  Project   : $PROJECT_NAME"
-echo "  Feature   : $FEATURE_NAME"
-echo "  Scope     : $SCOPE"
-echo "  Plan mode : $PLAN_MODE"
+echo "  Project      : $PROJECT_NAME"
+echo "  Feature      : $FEATURE_NAME"
+echo "  Scope        : $SCOPE"
+echo "  Plan mode    : $PLAN_MODE"
+echo "  Reading mode : $READING_MODE"
 echo ""
 
 # --- Update manifest.yml ---
@@ -102,6 +121,7 @@ content = re.sub(r'scope:\s*"pilot"', 'scope: "$SCOPE"', content)
 content = re.sub(r'feature:\s*""', 'feature: "$FEATURE_NAME"', content)
 content = re.sub(r'context_file:\s*""', 'context_file: "$FEATURE_NAME.md"', content)
 content = re.sub(r'plan_mode:\s*"unified"', 'plan_mode: "$PLAN_MODE"', content)
+content = re.sub(r'reading_mode:\s*"auto"', 'reading_mode: "$READING_MODE"', content)
 with open("$MANIFEST", "w") as f:
     f.write(content)
 PYEOF

{sddflow-2.7.91 → sddflow-2.7.92}/sdd/packs/sdd-mobile/.specify/manifest.yml

@@ -32,5 +32,5 @@ testing_style: "paired"
 # If using sdd-universal instead, set project_type: "mobile" in its manifest.yml
 # project_type: "mobile"
 
-sdd_version: "2.7.91"   # set by sdd init; used by sdd upgrade
+sdd_version: "2.7.92"   # set by sdd init; used by sdd upgrade
 ai_tool: ""             # set by sdd init: claude-code | copilot | cursor | windsurf | other

{sddflow-2.7.91/sdd/packs/sdd-backend-service → sddflow-2.7.92/sdd/packs/sdd-mobile}/setup.ps1

@@ -1,12 +1,13 @@
 # SDD Framework — Project Initializer (PowerShell)
-# Usage: .\setup.ps1 [-Project <name>] [-Scope pilot|mvp|full] [-Feature <name>] [-PlanMode unified|separate]
+# Usage: .\setup.ps1 [-Project <name>] [-Scope pilot|mvp|full] [-Feature <name>] [-PlanMode unified|separate] [-ReadingMode auto|summary|full]
 # Run this once after copying the pack into your project directory.
 
 param(
-  [string]$Project  = "",
-  [string]$Scope    = "",
-  [string]$Feature  = "",
-  [string]$PlanMode = ""
+  [string]$Project     = "",
+  [string]$Scope       = "",
+  [string]$Feature     = "",
+  [string]$PlanMode    = "",
+  [string]$ReadingMode = ""
 )
 
 Write-Host ""
@@ -60,12 +61,31 @@ if (-not $PlanMode) {
   }
 }
 
+if (-not $ReadingMode) {
+  if ($Interactive) {
+    Write-Host ""
+    Write-Host "Document reading mode (token economy — see summary-rules.md):"
+    Write-Host "  auto    — use each doc's .summary.md when present, fall back to the"
+    Write-Host "            full document (and generate a summary) when it's missing."
+    Write-Host "            Good for: almost everyone — self-heals, never stuck."
+    Write-Host "  summary — always use .summary.md; warns instead of reading the full"
+    Write-Host "            doc if one is missing. Good for: strict token budgets."
+    Write-Host "  full    — always read the full document, every command. Good for:"
+    Write-Host "            deep debugging, or migrating a project with no summaries."
+    $ReadingModeInput = Read-Host "Reading mode [auto]"
+    $ReadingMode = if ($ReadingModeInput) { $ReadingModeInput } else { "auto" }
+  } else {
+    $ReadingMode = "auto"
+  }
+}
+
 Write-Host ""
 Write-Host "Setting up:"
-Write-Host "  Project   : $Project"
-Write-Host "  Feature   : $Feature"
-Write-Host "  Scope     : $Scope"
-Write-Host "  Plan mode : $PlanMode"
+Write-Host "  Project      : $Project"
+Write-Host "  Feature      : $Feature"
+Write-Host "  Scope        : $Scope"
+Write-Host "  Plan mode    : $PlanMode"
+Write-Host "  Reading mode : $ReadingMode"
 Write-Host ""
 
 # --- Update manifest.yml ---
@@ -77,6 +97,7 @@ if (Test-Path $ManifestPath) {
   $content = $content -replace 'feature:\s*""',             "feature: `"$Feature`""
   $content = $content -replace 'context_file:\s*""',        "context_file: `"$Feature.md`""
   $content = $content -replace 'plan_mode:\s*"unified"',    "plan_mode: `"$PlanMode`""
+  $content = $content -replace 'reading_mode:\s*"auto"',    "reading_mode: `"$ReadingMode`""
   Set-Content $ManifestPath $content
   Write-Host "  [OK]  .specify\manifest.yml filled"
 } else {

{sddflow-2.7.91/sdd/packs/sdd-backend-service → sddflow-2.7.92/sdd/packs/sdd-mobile}/setup.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # SDD Framework — Project Initializer
-# Usage: bash setup.sh [--project <name>] [--scope pilot|mvp|full] [--feature <name>] [--plan-mode unified|separate]
+# Usage: bash setup.sh [--project <name>] [--scope pilot|mvp|full] [--feature <name>] [--plan-mode unified|separate] [--reading-mode auto|summary|full]
 # Run this once after copying the pack into your project directory.
 
 set -euo pipefail
@@ -17,13 +17,15 @@ SCOPE=""
 FEATURE_NAME=""
 
 PLAN_MODE=""
+READING_MODE=""
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    --project)    PROJECT_NAME="$2"; shift 2;;
-    --scope)      SCOPE="$2";        shift 2;;
-    --feature)    FEATURE_NAME="$2"; shift 2;;
-    --plan-mode)  PLAN_MODE="$2";    shift 2;;
+    --project)      PROJECT_NAME="$2"; shift 2;;
+    --scope)        SCOPE="$2";        shift 2;;
+    --feature)      FEATURE_NAME="$2"; shift 2;;
+    --plan-mode)    PLAN_MODE="$2";    shift 2;;
+    --reading-mode) READING_MODE="$2"; shift 2;;
     *) echo "Unknown option: $1"; exit 1;;
   esac
 done
@@ -81,12 +83,29 @@ if [[ -z "$PLAN_MODE" ]]; then
   PLAN_MODE="${PLAN_MODE:-unified}"
 fi
 
+if [[ -z "$READING_MODE" ]]; then
+  if [[ $INTERACTIVE -eq 1 ]]; then
+    echo ""
+    echo "Document reading mode (token economy — see summary-rules.md):"
+    echo "  auto    — use each doc's .summary.md when present, fall back to the"
+    echo "            full document (and generate a summary) when it's missing."
+    echo "            Good for: almost everyone — self-heals, never stuck."
+    echo "  summary — always use .summary.md; warns instead of reading the full"
+    echo "            doc if one is missing. Good for: strict token budgets."
+    echo "  full    — always read the full document, every command. Good for:"
+    echo "            deep debugging, or migrating a project with no summaries."
+    read -r -p "Reading mode [auto]: " READING_MODE
+  fi
+  READING_MODE="${READING_MODE:-auto}"
+fi
+
 echo ""
 echo "Setting up:"
-echo "  Project   : $PROJECT_NAME"
-echo "  Feature   : $FEATURE_NAME"
-echo "  Scope     : $SCOPE"
-echo "  Plan mode : $PLAN_MODE"
+echo "  Project      : $PROJECT_NAME"
+echo "  Feature      : $FEATURE_NAME"
+echo "  Scope        : $SCOPE"
+echo "  Plan mode    : $PLAN_MODE"
+echo "  Reading mode : $READING_MODE"
 echo ""
 
 # --- Update manifest.yml ---
@@ -102,6 +121,7 @@ content = re.sub(r'scope:\s*"pilot"', 'scope: "$SCOPE"', content)
 content = re.sub(r'feature:\s*""', 'feature: "$FEATURE_NAME"', content)
 content = re.sub(r'context_file:\s*""', 'context_file: "$FEATURE_NAME.md"', content)
 content = re.sub(r'plan_mode:\s*"unified"', 'plan_mode: "$PLAN_MODE"', content)
+content = re.sub(r'reading_mode:\s*"auto"', 'reading_mode: "$READING_MODE"', content)
 with open("$MANIFEST", "w") as f:
     f.write(content)
 PYEOF

{sddflow-2.7.91 → sddflow-2.7.92}/sdd/packs/sdd-universal/.specify/manifest.yml

@@ -38,5 +38,5 @@ plan_mode: "unified"
 #   bdd:    Given/When/Then specs drive tests, written before implementation
 testing_style: "paired"
 
-sdd_version: "2.7.91"   # set by sdd init; used by sdd upgrade
+sdd_version: "2.7.92"   # set by sdd init; used by sdd upgrade
 ai_tool: ""             # set by sdd init: claude-code | copilot | cursor | windsurf | other