@bvdm/delano 0.2.3 → 0.2.5

package/assets/payload/.delano/viewer/server.js

@@ -12,7 +12,16 @@ const { spawn, spawnSync } = require('node:child_process');
 const repoRoot = path.resolve(process.env.DELANO_VIEWER_ROOT || path.resolve(__dirname, '..', '..'));
 const projectRoot = path.join(repoRoot, '.project');
 const publicRoot = path.join(__dirname, 'public');
-const port = Number(process.env.DELANO_VIEWER_PORT || process.env.PORT || 3977);
+const DEFAULT_PORT = 3977;
+const MAX_PORT = 65535;
+const MAX_PORT_ATTEMPTS = 100;
+const startPort = normalizePort(process.env.DELANO_VIEWER_PORT || process.env.PORT, DEFAULT_PORT);
+
+function normalizePort(value, fallback) {
+  const parsed = Number(value || fallback);
+  if (!Number.isInteger(parsed) || parsed < 1 || parsed > MAX_PORT) return fallback;
+  return parsed;
+}
 
 function isInside(parent, child) {
   const rel = path.relative(parent, child);
@@ -332,6 +341,7 @@ function sendStatic(res, pathname) {
   const ext = path.extname(resolved).toLowerCase();
   const mimeMap = {
     '.js': 'text/javascript',
+    '.jsx': 'text/javascript',
     '.css': 'text/css',
     '.svg': 'image/svg+xml',
     '.png': 'image/png',
@@ -340,7 +350,7 @@ function sendStatic(res, pathname) {
     '.webp': 'image/webp',
     '.ico': 'image/x-icon',
   };
-  const isText = ext === '.js' || ext === '.css' || ext === '.svg' || ext === '' || ext === '.html';
+  const isText = ext === '.js' || ext === '.jsx' || ext === '.css' || ext === '.svg' || ext === '' || ext === '.html';
   const type = mimeMap[ext] || 'text/html';
   const headers = isText ? { 'content-type': `${type}; charset=utf-8` } : { 'content-type': type };
   res.writeHead(200, headers);
@@ -384,6 +394,37 @@ const server = http.createServer((req, res) => {
   }
 });
 
-server.listen(port, '127.0.0.1', () => {
-  console.log(`Delano read-only viewer: http://127.0.0.1:${port}`);
-});
+function listenWithPortFallback(server, firstPort, host = '127.0.0.1') {
+  let port = firstPort;
+  let attempts = 0;
+
+  const listen = () => {
+    server.once('error', onError);
+    server.listen(port, host);
+  };
+
+  const onError = (error) => {
+    if (error.code === 'EADDRINUSE' && port < MAX_PORT && attempts < MAX_PORT_ATTEMPTS) {
+      attempts += 1;
+      port += 1;
+      listen();
+      return;
+    }
+
+    console.error(`Failed to start Delano viewer on ${host}:${port}: ${error.message}`);
+    process.exitCode = 1;
+  };
+
+  const onListening = () => {
+    server.removeListener('error', onError);
+    const address = server.address();
+    const actualPort = typeof address === 'object' && address ? address.port : port;
+    const skipped = actualPort !== firstPort ? ` (${firstPort} was unavailable)` : '';
+    console.log(`Delano read-only viewer: http://${host}:${actualPort}${skipped}`);
+  };
+
+  server.on('listening', onListening);
+  listen();
+}
+
+listenWithPortFallback(server, startPort);

package/assets/payload/.project/templates/decisions.md

@@ -0,0 +1,18 @@
+---
+name: <project-name>
+slug: <kebab-case>
+owner: <person-or-team>
+created: <ISO8601 UTC>
+updated: <ISO8601 UTC>
+---
+
+# Decisions: <project-name>
+
+## Active Decisions
+- No decisions recorded at creation.
+
+## Superseded Decisions
+- None.
+
+## Open Decision Questions
+- None recorded at creation.

package/assets/payload/.project/templates/plan.md

@@ -13,8 +13,25 @@ spec_status_at_plan_time: <planned|active|complete|deferred>
 
 ## What Changed After Probe
 
+## Technical Context
+
 ## Architecture Decisions
 
+## Policy and Contract Checks
+- [ ] `.project` remains the execution source of truth
+- [ ] Probe decision is explicit
+- [ ] Evidence gates are defined before handoff
+- [ ] External sync writes require dry-run or operator approval
+
+## Generated Artifact Map
+- `spec.md`: <source or generation notes>
+- `plan.md`: <source or generation notes>
+- `workstreams/`: <source or generation notes>
+- `tasks/`: <source or generation notes>
+
+## Complexity Exceptions
+- <exception, rationale, and owner>
+
 ## Probe-Driven Architecture Changes
 
 ## Workstream Design

package/assets/payload/.project/templates/spec.md

@@ -19,6 +19,12 @@ probe_status: <pending|skipped|completed>
 
 ## Outcome and Success Metrics
 
+## User Stories
+- US-001: As a <user>, I want <capability>, so that <outcome>.
+
+## Acceptance Scenarios
+- AC-001: Given <context>, when <action>, then <observable result>.
+
 ## Scope
 ### In Scope
 ### Out of Scope
@@ -27,6 +33,12 @@ probe_status: <pending|skipped|completed>
 
 ## Non-Functional Requirements
 
+## Assumptions
+- <assumption to validate>
+
+## Needs Clarification
+- <question that must be answered before activation or execution>
+
 ## Hypotheses and Unknowns
 
 ## Touchpoints to Exercise

package/assets/payload/.project/templates/task.md

@@ -13,6 +13,8 @@ conflicts_with: []
 parallel: true
 priority: medium
 estimate: M
+story_id:
+acceptance_criteria_ids: []
 ---
 
 # Task: <task-title>
@@ -22,6 +24,10 @@ estimate: M
 ## Acceptance Criteria
 - [ ]
 
+## Traceability
+- Story: <story_id or none>
+- Acceptance criteria: <acceptance criteria ids or none>
+
 ## Technical Notes
 
 ## Definition of Done

package/assets/payload/.project/templates/workstream.md

@@ -1,4 +1,5 @@
 ---
+id: WS-A
 name: WS-A API Foundation
 owner: backend-team
 status: planned

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bvdm/delano",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "CLI for the Delano delivery runtime.",
   "license": "MIT",
   "repository": {
@@ -58,6 +58,8 @@
     "check:project-metrics": "node scripts/summarize-project-metrics.mjs --json",
     "check:context-audit": "node scripts/check-context-audit.mjs",
     "check:skill-output-evals": "node scripts/check-skill-output-evals.mjs",
-    "check:closeout-learning": "node scripts/propose-closeout-learning.mjs --json && node scripts/check-closeout-learning-proposals.mjs"
+    "check:closeout-learning": "node scripts/propose-closeout-learning.mjs --json && node scripts/check-closeout-learning-proposals.mjs",
+    "check:spec-kit-interop": "node scripts/check-spec-kit-interop-fixtures.mjs",
+    "check:adapter-manifests": "node scripts/check-adapter-manifests.mjs"
   }
 }

package/src/cli/commands/install.js

@@ -30,7 +30,7 @@ function getInstallHelp() {
     "  -h, --help         Show command help.",
     "",
     "Categories:",
-    "  agent-runtime, skills, viewer, project-context, project-templates,",
+    "  agent-runtime, codex-hooks, skills, viewer, project-context, project-templates,",
     "  project-registry, project-projects, handbook, legacy-installer",
     "",
     "Behavior:",
@@ -38,6 +38,7 @@ function getInstallHelp() {
     "  - Aborts on conflicts by default.",
     "  - Filters the plan before conflict detection when --only or --exclude is used.",
     "  - Treats .project/context, .project/projects, and .project/registry as repo-owned state after install.",
+    "  - Merges .codex/hooks.json when it exists; invalid or non-file hook configs are skipped without blocking install.",
     "  - Only installs the approved base payload; top-level adapter entry docs remain opt-in and are not installed in v1.",
     "",
     "Examples:",