aw-spec-cli 0.1.22 → 0.1.24

package/assets/.appweaver/scripts/powershell/aw-spec-actions.ps1

@@ -631,6 +631,9 @@ function Invoke-LaneResolve {
     for ($i = 0; $i -lt $Rest.Count; $i++) {
         switch ($Rest[$i]) {
             { $_ -in '--kind','--id' } { $fwd += $Rest[$i]; $fwd += $Rest[++$i] }
+            # An EMPTY --feature-dir is dropped: a workflow renders the argument whole, and a
+            # feature that is not resolved yet means "the repo's declaration as it stands".
+            '--feature-dir' { $v = $Rest[++$i]; if ($v) { $fwd += '--feature-dir'; $fwd += $v } }
             default { Write-Error "lane-resolve: unknown arg '$($Rest[$i])'"; exit 1 }
         }
     }
@@ -1084,6 +1087,31 @@ elif op == "init":
         d["bootstrap_pending"] = True
     save(d)
     out["created"] = (not existed)
+elif op == "lanes":
+    # WHICH DECLARED LANES THIS FEATURE HAS A SURFACE IN. Absent means every lane the repo
+    # declares, which is the ordinary case and needs no record. A feature that genuinely has
+    # no part of one lane's surface — a job-only or shared-kernel slice in a repo that also
+    # has a UI — records the kinds it does have, and `lane-resolve --feature-dir` then reports
+    # the other lane as not declared FOR THIS FEATURE, so no phase plans, gates or builds a
+    # surface the feature does not own. `all` removes the record; an empty value only reads.
+    # Refuses to create the file: init is its one creator, and a record with no version
+    # spine would read as a feature nobody specified.
+    want = os.environ.get("AW_LANES", "").strip()
+    if want and not existed:
+        out["ok"] = False
+        out["error"] = "no active_version.json for this feature yet — it is created by specify or adopt"
+    elif want == "all":
+        d.pop("lanes", None)
+        save(d)
+    elif want:
+        kinds = [k.strip() for k in want.split(",") if k.strip()]
+        bad = [k for k in kinds if k not in ("backend", "frontend")]
+        if bad or not kinds:
+            out["ok"] = False
+            out["error"] = "lanes takes backend, frontend or both (comma-separated), or all; got '%s'" % want
+        else:
+            d["lanes"] = [k for k in ("backend", "frontend") if k in kinds]
+            save(d)
 elif op == "bootstrap-done":
     # THE ONLY THING THAT CLEARS THE MARKER, called by the phase that raised it once the
     # first draft is actually finished. It is a separate op, not a side effect of writing
@@ -1183,6 +1211,7 @@ elif op == "close":
     out["previous"] = prev; out["closed_change"] = closed
     out["open_changes"] = opens; out["open_count"] = len(opens)
 out["bootstrap_pending"] = bool(d.get("bootstrap_pending"))
+out["lanes"] = list(d.get("lanes") or [])   # empty = every declared lane
 out["has_change"] = bool(out.get("active_change", ""))   # clean branch signal for design
 # What a close from THIS state would produce. One bump() authority, read by BOTH
 # finalize-delta (to write the right number into the Change History rows it appends)
@@ -1194,10 +1223,10 @@ print(json.dumps(out))
 '@
 
 function Invoke-ActiveVersion {
-    param([string]$FeatureDir, [string]$Op, [string]$CrId = '', [string]$Force = '', [string]$Boot = '')
+    param([string]$FeatureDir, [string]$Op, [string]$CrId = '', [string]$Force = '', [string]$Boot = '', [string]$Lanes = '')
     $py = Get-Py; if (-not $py) { Write-Error "version-$Op`: python3 required"; exit 1 }
     $env:AW_FD = $FeatureDir; $env:AW_OP = $Op; $env:AW_CR = $CrId; $env:AW_FORCE = $Force
-    $env:AW_BOOT = $Boot
+    $env:AW_BOOT = $Boot; $env:AW_LANES = $Lanes
     # CrId names the change on BOTH open and close: many may be open at once, so a close
     # has to say which one it is closing rather than assuming the only one.
     $PyActiveVersion | & $py -
@@ -1216,6 +1245,32 @@ function Invoke-VersionState {   # op in read|init (feature-dir only)
     Invoke-ActiveVersion -FeatureDir $fd -Op $Op -Boot $boot
 }
 
+# The lane kinds this feature has a surface in, recorded in its active_version.json. Twin
+# of bash cmd_feature_lanes: adopt records `backend` for a slice that owns no part of a
+# declared frontend's surface, and `lane-resolve --feature-dir` reads it back. No argument
+# reads; --clear drops the record so the feature follows every declared lane again.
+function Invoke-FeatureLanes {
+    param([string[]]$Rest)
+    $fdArg = ''; $lanes = ''
+    for ($i = 0; $i -lt $Rest.Count; $i++) {
+        switch ($Rest[$i]) {
+            { $_ -in '--feature-dir','-FeatureDir' } { $fdArg = $Rest[++$i] }
+            '--set'   { $lanes = $Rest[++$i] }
+            '--clear' { $lanes = 'all' }
+            default { Write-Error "feature-lanes: unknown arg '$($Rest[$i])'"; exit 1 }
+        }
+    }
+    $repo = Get-RepoRoot
+    $fd = Resolve-FeatureDir -Arg $fdArg -RepoRoot $repo
+    if (-not $fd) { Write-Error 'feature-lanes: no feature set and no --feature-dir'; exit 1 }
+    $out = Invoke-ActiveVersion -FeatureDir $fd -Op 'lanes' -Lanes $lanes
+    $out
+    # A refused write is a failure the caller has to see: the orchestrator reports a failed
+    # script from stderr, so the reason goes there too.
+    $res = $out | ConvertFrom-Json
+    if (-not $res.ok) { [Console]::Error.WriteLine("feature-lanes: $($res.error)"); exit 1 }
+}
+
 
 
 # ─────────────────────────── feature-paths ─────────────────────────────────
@@ -1230,6 +1285,14 @@ function Invoke-FeaturePaths {
     if (-not $fd) { Write-Error 'feature-paths: no feature set (run /appweaver select-feature first)'; exit 1 }
     if (-not [System.IO.Path]::IsPathRooted($fd)) { $fd = Join-Path $repo $fd }
     $feature = Split-Path $fd -Leaf   # the aggregate name (feature = specs/<Feature>)
+    # feature_slug is the URL-safe form of that name, and it is what the UI stages use
+    # as a route segment and a directory name (app/<slug>/page.tsx). It is derived here
+    # rather than per workflow so every reader gets the same segment for one feature.
+    # CamelCase splits on the case boundary before the non-alphanumeric squeeze, so
+    # OrderManagement and "Order Management" both reach order-management.
+    $featureSlug = $feature -creplace '([a-z0-9])([A-Z])', '$1-$2'
+    $featureSlug = $featureSlug -creplace '([A-Z]+)([A-Z][a-z])', '$1-$2'
+    $featureSlug = ($featureSlug.ToLowerInvariant() -replace '[^a-z0-9]+', '-').Trim('-')
     # The master documents of a feature: spec.md (WHAT/WHY) + one LANE PLAN per declared
     # lane (each lane's HOW) — backend-plan.md for the service lane, frontend-plan.md for
     # the frontend lane. `plan` writes them; nothing else does.
@@ -1264,6 +1327,7 @@ function Invoke-FeaturePaths {
     $specExists = (Test-Path $spec)
     Write-Json ([ordered]@{
         feature             = $feature
+        feature_slug        = $featureSlug
         feature_dir         = $fd
         spec_file           = $spec
         backend_plan        = $design
@@ -4394,6 +4458,7 @@ switch ($sub) {
     'version-read'     { Invoke-VersionState 'read'  $rest }
     'version-init'     { Invoke-VersionState 'init'  $rest }
     'version-bootstrap-done' { Invoke-VersionState 'bootstrap-done' $rest }
+    'feature-lanes'    { Invoke-FeatureLanes     -Rest $rest }
     'feature-paths'    { Invoke-FeaturePaths     -Rest $rest }
     'design-scaffold'  { Invoke-DesignScaffold   -Rest $rest }
     # The plan phase's name for the same op. Both spellings reach one implementation: