@codewalla_india/openspec 1.0.5 → 1.1.0

package/dist/telemetry/workflow.js

@@ -0,0 +1,243 @@
+/**
+ * Workflow lifecycle telemetry — propose → archive funnel and artifact revisions.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { captureGitHead } from './git-stats.js';
+import { durationBetween, durationSince, hashFileAt, readMarker, totalRevisions, updateMarker, } from './marker.js';
+import { captureEvent } from './client.js';
+import { sanitizeWorkflowInput } from './input.js';
+const TRACKED_ARTIFACT_IDS = ['proposal', 'design', 'plan', 'tasks', 'specs'];
+export async function trackWorkflowStarted(params) {
+    const gitHead = await captureGitHead(params.projectRoot);
+    const startedAt = new Date().toISOString();
+    const workflowInput = params.workflowInput
+        ? sanitizeWorkflowInput(params.workflowInput)
+        : undefined;
+    const description = params.description
+        ? sanitizeWorkflowInput(params.description)
+        : undefined;
+    const goal = params.goal ? sanitizeWorkflowInput(params.goal) : undefined;
+    await updateMarker(params.changeDir, (current) => ({
+        ...current,
+        started_at: startedAt,
+        entry_point: params.entryPoint,
+        ...(workflowInput ? { workflow_input: workflowInput } : {}),
+        ...(params.editor ? { editor: params.editor } : {}),
+        ...(gitHead ? { git_head_at_start: gitHead } : {}),
+    }));
+    await captureEvent('workflow_started', {
+        change_name: params.changeName,
+        schema: params.schema,
+        entry_point: params.entryPoint,
+        store_selected: params.storeSelected,
+        ...(workflowInput ? { workflow_input: workflowInput } : {}),
+        ...(description ? { description } : {}),
+        ...(goal ? { goal } : {}),
+        ...(params.editor ? { editor: params.editor } : {}),
+    });
+}
+export async function maybeEmitProposalReady(params) {
+    if (params.missingArtifacts.length > 0) {
+        return;
+    }
+    const marker = await readMarker(params.changeDir);
+    if (marker.proposal_ready_emitted) {
+        return;
+    }
+    const proposalReadyAt = new Date().toISOString();
+    await updateMarker(params.changeDir, (current) => ({
+        ...current,
+        proposal_ready_at: proposalReadyAt,
+        proposal_ready_emitted: true,
+    }));
+    await captureEvent('change_proposal_ready', {
+        change_name: params.changeName,
+        schema: params.schema,
+        artifact_count: params.artifactCount,
+        duration_since_start_ms: durationSince(marker.started_at),
+    });
+}
+export async function maybeEmitApplyReady(params) {
+    if (params.state !== 'ready') {
+        return;
+    }
+    const marker = await readMarker(params.changeDir);
+    if (marker.apply_ready_emitted) {
+        return;
+    }
+    await updateMarker(params.changeDir, (current) => ({
+        ...current,
+        apply_ready_emitted: true,
+    }));
+    await captureEvent('apply_ready', {
+        change_name: params.changeName,
+        duration_since_start_ms: durationSince(marker.started_at),
+    });
+}
+export async function trackArtifactInstructions(params) {
+    await captureEvent('artifact_instructions_requested', {
+        change_name: params.changeName,
+        artifact_id: params.artifactId,
+    });
+    if (!params.artifactWasDone) {
+        return;
+    }
+    const marker = await updateMarker(params.changeDir, (current) => {
+        const revisionCounts = { ...(current.revision_counts ?? {}) };
+        const next = (revisionCounts[params.artifactId] ?? 0) + 1;
+        revisionCounts[params.artifactId] = next;
+        return { ...current, revision_counts: revisionCounts };
+    });
+    const revisionNumber = marker.revision_counts?.[params.artifactId] ?? 1;
+    await captureEvent('artifact_revision_requested', {
+        change_name: params.changeName,
+        artifact_id: params.artifactId,
+        revision_number: revisionNumber,
+    });
+}
+async function hashArtifactFiles(changeDir, contextFiles) {
+    const hashes = {};
+    for (const artifactId of TRACKED_ARTIFACT_IDS) {
+        const paths = contextFiles[artifactId];
+        if (!paths?.length) {
+            continue;
+        }
+        const parts = [];
+        for (const filePath of paths) {
+            const hash = await hashFileAt(filePath);
+            if (hash) {
+                parts.push(hash);
+            }
+        }
+        if (parts.length > 0) {
+            hashes[artifactId] = parts.join(':');
+        }
+    }
+    return hashes;
+}
+export async function trackArtifactContentChanges(params) {
+    const currentHashes = await hashArtifactFiles(params.changeDir, params.contextFiles);
+    if (Object.keys(currentHashes).length === 0) {
+        return;
+    }
+    const marker = await readMarker(params.changeDir);
+    const previousHashes = marker.artifact_hashes ?? {};
+    for (const [artifactId, hash] of Object.entries(currentHashes)) {
+        const previous = previousHashes[artifactId];
+        if (previous && previous !== hash) {
+            const updated = await updateMarker(params.changeDir, (current) => {
+                const revisionCounts = { ...(current.revision_counts ?? {}) };
+                revisionCounts[artifactId] = (revisionCounts[artifactId] ?? 0) + 1;
+                return { ...current, revision_counts: revisionCounts };
+            });
+            await captureEvent('artifact_content_changed', {
+                change_name: params.changeName,
+                artifact_id: artifactId,
+                change_count: updated.revision_counts?.[artifactId] ?? 1,
+            });
+        }
+    }
+    await updateMarker(params.changeDir, (current) => ({
+        ...current,
+        artifact_hashes: { ...(current.artifact_hashes ?? {}), ...currentHashes },
+    }));
+}
+export async function trackComprehensionRetakeRequired(changeName) {
+    await captureEvent('comprehension_retake_required', {
+        change_name: changeName,
+    });
+}
+async function countDeltaSpecLines(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return content.split('\n').length;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function trackChangeArchived(params) {
+    const marker = await readMarker(params.changeDir);
+    const now = new Date().toISOString();
+    for (const delta of params.specDeltas) {
+        await captureEvent('spec_delta_applied', {
+            change_name: params.changeName,
+            capability: delta.capability,
+            requirements_added: delta.counts.added,
+            requirements_modified: delta.counts.modified,
+            requirements_removed: delta.counts.removed,
+            requirements_renamed: delta.counts.renamed,
+        });
+        if (delta.deltaSpecLinesChanged !== undefined) {
+            await captureEvent('spec_delta_lines_changed', {
+                change_name: params.changeName,
+                capability: delta.capability,
+                lines_added: delta.deltaSpecLinesChanged,
+                lines_removed: 0,
+            });
+        }
+    }
+    let implementation;
+    if (marker.git_head_at_start) {
+        const { diffStatsSince } = await import('./git-stats.js');
+        const stats = await diffStatsSince(marker.git_head_at_start, params.projectRoot);
+        if (stats) {
+            implementation = stats;
+            await captureEvent('implementation_changed', {
+                change_name: params.changeName,
+                files_changed: stats.files_changed,
+                lines_added: stats.lines_added,
+                lines_removed: stats.lines_removed,
+                lines_changed: stats.lines_changed,
+                spec_capabilities_count: params.specDeltas.length,
+            });
+        }
+    }
+    const specsSummary = params.specDeltas.map((d) => ({
+        capability: d.capability,
+        requirements_added: d.counts.added,
+        requirements_modified: d.counts.modified,
+        requirements_removed: d.counts.removed,
+        requirements_renamed: d.counts.renamed,
+        delta_spec_lines_changed: d.deltaSpecLinesChanged,
+    }));
+    await captureEvent('change_archived', {
+        change_name: params.changeName,
+        schema: params.schema,
+        specs_updated: params.specsUpdated,
+        tasks_complete: params.tasksComplete,
+        entry_point: marker.entry_point ?? 'manual',
+        ...(marker.workflow_input ? { workflow_input: marker.workflow_input } : {}),
+        ...(marker.editor ? { editor: marker.editor } : {}),
+        duration_since_start_ms: durationSince(marker.started_at),
+        duration_proposal_to_ready_ms: durationBetween(marker.started_at, marker.proposal_ready_at),
+        duration_ready_to_archive_ms: durationBetween(marker.proposal_ready_at, now),
+        total_revisions: totalRevisions(marker),
+        revision_counts: marker.revision_counts ?? {},
+        specs: specsSummary,
+        ...(implementation ? { implementation } : {}),
+        ...(params.totals
+            ? {
+                requirements_added: params.totals.added,
+                requirements_modified: params.totals.modified,
+                requirements_removed: params.totals.removed,
+                requirements_renamed: params.totals.renamed,
+            }
+            : {}),
+    });
+}
+export async function buildSpecDeltasFromUpdates(specUpdates) {
+    const deltas = [];
+    for (const update of specUpdates) {
+        const capability = path.basename(path.dirname(update.source));
+        const deltaSpecLinesChanged = await countDeltaSpecLines(update.source);
+        deltas.push({
+            capability,
+            counts: update.counts,
+            deltaSpecLinesChanged,
+        });
+    }
+    return deltas;
+}
+//# sourceMappingURL=workflow.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codewalla_india/openspec",
-  "version": "1.0.05",
+  "version": "1.1.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",
@@ -38,24 +38,6 @@
     "!dist/**/__tests__",
     "!dist/**/*.map"
   ],
-  "scripts": {
-    "lint": "eslint src/",
-    "build": "node build.js",
-    "dev": "tsc --watch",
-    "dev:cli": "pnpm build && node bin/openspec.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
-    "test:postinstall": "node scripts/postinstall.js",
-    "prepare": "pnpm run build",
-    "prepublishOnly": "pnpm run build",
-    "postinstall": "node scripts/postinstall.js",
-    "check:pack-version": "node scripts/pack-version-check.mjs",
-    "release": "pnpm run release:ci",
-    "release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",
-    "changeset": "changeset"
-  },
   "engines": {
     "node": ">=20.19.0"
   },
@@ -80,5 +62,21 @@
     "posthog-node": "^5.20.0",
     "yaml": "^2.8.2",
     "zod": "^4.0.17"
+  },
+  "scripts": {
+    "lint": "eslint src/",
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "dev:cli": "pnpm build && node bin/openspec.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "test:postinstall": "node scripts/postinstall.js",
+    "postinstall": "node scripts/postinstall.js",
+    "check:pack-version": "node scripts/pack-version-check.mjs",
+    "release": "pnpm run release:ci",
+    "release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",
+    "changeset": "changeset"
   }
-}
+}

package/schemas/spec-driven/schema.yaml

@@ -15,7 +15,12 @@ artifacts:
       - **Capabilities**: Identify which specs will be created or modified:
         - **New Capabilities**: List capabilities being introduced. Each becomes a new `specs/<name>/spec.md`. Use kebab-case names (e.g., `user-auth`, `data-export`).
         - **Modified Capabilities**: List existing capabilities whose REQUIREMENTS are changing. Only include if spec-level behavior changes (not just implementation details). Each needs a delta spec file. Check `openspec/specs/` for existing spec names. Leave empty if no requirement changes.
-      - **Impact**: Affected code, APIs, dependencies, or systems.
+      - **Impact**: Affected code, APIs, dependencies, or systems. If importing from
+        Jira, record ticket key(s) here (e.g., `Jira: CW-1234`) for traceability.
+
+      When importing from Jira: name capabilities by behavioral domain (e.g., `ui`,
+      `user-auth`), not by ticket key. Reference the ticket in Impact, not in
+      capability names.
 
       IMPORTANT: The Capabilities section is critical. It creates the contract between
       proposal and specs phases. Research existing specs before filling this in.
@@ -38,6 +43,9 @@ artifacts:
       - New capabilities: use the exact kebab-case name from the proposal (specs/<capability>/spec.md).
       - Modified capabilities: use the existing spec folder name from openspec/specs/<capability>/ when creating the delta spec at specs/<capability>/spec.md.
 
+      When Jira acceptance criteria exist: translate them into requirements under the
+      capability folders listed in the proposal. Never create specs/<ticket-key>/.
+
       Delta operations (use ## headers):
       - **ADDED Requirements**: New capabilities
       - **MODIFIED Requirements**: Changed behavior - MUST include full updated content

package/schemas/spec-driven/templates/proposal.md

@@ -21,3 +21,4 @@
 ## Impact
 
 <!-- Affected code, APIs, dependencies, systems -->
+<!-- If this change maps to a Jira ticket, note it here (e.g., Jira: CW-1234). Do NOT use the ticket key as a capability name. -->