@codewalla_india/openspec 1.3.1 → 1.3.2

package/dist/telemetry/input.d.ts

@@ -1,17 +0,0 @@
-export declare const VALID_EDITORS: readonly ["cursor", "windsurf", "claude"];
-export type WorkflowEditor = (typeof VALID_EDITORS)[number];
-export declare const MAX_ARTIFACT_BODY_LENGTH = 8000;
-export declare function sanitizeTelemetryContent(text: string, maxLength?: number): string;
-export declare function sanitizeWorkflowInput(text: string): string;
-export declare function readSanitizedFile(filePath: string, maxLength?: number): Promise<string>;
-export declare function readWorkflowInputFile(filePath: string): Promise<string>;
-export declare function normalizeEditor(value?: string): WorkflowEditor | undefined;
-export declare function resolveWorkflowInput(options: {
-    workflowInput?: string;
-    workflowInputFile?: string;
-}): string | undefined;
-export declare function resolveWorkflowInputAsync(options: {
-    workflowInput?: string;
-    workflowInputFile?: string;
-}): Promise<string | undefined>;
-//# sourceMappingURL=input.d.ts.map

package/dist/telemetry/input.js

@@ -1,68 +0,0 @@
-/**
- * Workflow input normalization for Codewalla telemetry.
- */
-import { promises as fs } from 'fs';
-export const VALID_EDITORS = ['cursor', 'windsurf', 'claude'];
-const MAX_WORKFLOW_INPUT_LENGTH = 2000;
-export const MAX_ARTIFACT_BODY_LENGTH = 8000;
-const SECRET_PATTERNS = [
-    /\bsk-[a-zA-Z0-9_-]{8,}\b/g,
-    /\bghp_[a-zA-Z0-9]{20,}\b/g,
-    /Bearer\s+[a-zA-Z0-9._-]+/gi,
-];
-function redactSecrets(text) {
-    let sanitized = text.trim();
-    for (const pattern of SECRET_PATTERNS) {
-        sanitized = sanitized.replace(pattern, '[redacted]');
-    }
-    return sanitized;
-}
-export function sanitizeTelemetryContent(text, maxLength = MAX_WORKFLOW_INPUT_LENGTH) {
-    const sanitized = redactSecrets(text);
-    if (sanitized.length > maxLength) {
-        return sanitized.slice(0, maxLength);
-    }
-    return sanitized;
-}
-export function sanitizeWorkflowInput(text) {
-    return sanitizeTelemetryContent(text, MAX_WORKFLOW_INPUT_LENGTH);
-}
-export async function readSanitizedFile(filePath, maxLength = MAX_ARTIFACT_BODY_LENGTH) {
-    const content = await fs.readFile(filePath, 'utf-8');
-    return sanitizeTelemetryContent(content, maxLength);
-}
-export async function readWorkflowInputFile(filePath) {
-    const content = await fs.readFile(filePath, 'utf-8');
-    return sanitizeWorkflowInput(content);
-}
-export function normalizeEditor(value) {
-    if (!value) {
-        return undefined;
-    }
-    const normalized = value.trim().toLowerCase();
-    if (VALID_EDITORS.includes(normalized)) {
-        return normalized;
-    }
-    throw new Error(`Invalid --editor "${value}". Use: ${VALID_EDITORS.join(', ')}.`);
-}
-export function resolveWorkflowInput(options) {
-    if (options.workflowInput !== undefined && options.workflowInputFile !== undefined) {
-        throw new Error('Pass only one of --workflow-input or --workflow-input-file.');
-    }
-    if (options.workflowInput !== undefined) {
-        const sanitized = sanitizeWorkflowInput(options.workflowInput);
-        return sanitized.length > 0 ? sanitized : undefined;
-    }
-    return undefined;
-}
-export async function resolveWorkflowInputAsync(options) {
-    if (options.workflowInput !== undefined && options.workflowInputFile !== undefined) {
-        throw new Error('Pass only one of --workflow-input or --workflow-input-file.');
-    }
-    if (options.workflowInputFile !== undefined) {
-        const sanitized = await readWorkflowInputFile(options.workflowInputFile);
-        return sanitized.length > 0 ? sanitized : undefined;
-    }
-    return resolveWorkflowInput(options);
-}
-//# sourceMappingURL=input.js.map

package/dist/telemetry/marker.d.ts

@@ -1,37 +0,0 @@
-export declare const CHANGE_TELEMETRY_FILENAME = ".openspec-telemetry.yaml";
-export type EntryPoint = 'propose' | 'new' | 'ff' | 'manual';
-export interface ModifyHistoryEntry {
-    at: string;
-    source_artifact: string;
-    modify_input?: string;
-}
-export interface ChangeTelemetryMarker {
-    started_at?: string;
-    entry_point?: EntryPoint;
-    workflow_input?: string;
-    editor?: string;
-    git_head_at_start?: string;
-    proposal_ready_at?: string;
-    proposal_ready_emitted?: boolean;
-    apply_ready_emitted?: boolean;
-    artifact_hashes?: Record<string, string>;
-    artifact_body_cache?: Record<string, string>;
-    revision_counts?: Record<string, number>;
-    modify_history?: ModifyHistoryEntry[];
-    comprehension_attempt_count?: number;
-    comprehension_failure_count?: number;
-    comprehension_gate_last_emitted?: {
-        passed: boolean;
-        best_score_percent?: number;
-    };
-}
-export declare function markerPath(changeDir: string): string;
-export declare function readMarker(changeDir: string): Promise<ChangeTelemetryMarker>;
-export declare function writeMarker(changeDir: string, marker: ChangeTelemetryMarker): Promise<void>;
-export declare function updateMarker(changeDir: string, update: (current: ChangeTelemetryMarker) => ChangeTelemetryMarker): Promise<ChangeTelemetryMarker>;
-export declare function hashFileContent(content: string): string;
-export declare function hashFileAt(filePath: string): Promise<string | null>;
-export declare function durationSince(isoStart: string | undefined): number | undefined;
-export declare function durationBetween(isoStart: string | undefined, isoEnd: string | undefined): number | undefined;
-export declare function totalRevisions(marker: ChangeTelemetryMarker): number;
-//# sourceMappingURL=marker.d.ts.map

package/dist/telemetry/marker.js

@@ -1,67 +0,0 @@
-/**
- * Change-local telemetry marker (.openspec-telemetry.yaml) for dedupe and durations.
- */
-import { createHash } from 'crypto';
-import { promises as fs } from 'fs';
-import path from 'path';
-import { parse, stringify } from 'yaml';
-export const CHANGE_TELEMETRY_FILENAME = '.openspec-telemetry.yaml';
-export function markerPath(changeDir) {
-    return path.join(changeDir, CHANGE_TELEMETRY_FILENAME);
-}
-export async function readMarker(changeDir) {
-    try {
-        const content = await fs.readFile(markerPath(changeDir), 'utf-8');
-        return parse(content) ?? {};
-    }
-    catch {
-        return {};
-    }
-}
-export async function writeMarker(changeDir, marker) {
-    await fs.writeFile(markerPath(changeDir), stringify(marker), 'utf-8');
-}
-export async function updateMarker(changeDir, update) {
-    const current = await readMarker(changeDir);
-    const next = update(current);
-    await writeMarker(changeDir, next);
-    return next;
-}
-export function hashFileContent(content) {
-    return createHash('sha256').update(content).digest('hex').slice(0, 16);
-}
-export async function hashFileAt(filePath) {
-    try {
-        const content = await fs.readFile(filePath, 'utf-8');
-        return hashFileContent(content);
-    }
-    catch {
-        return null;
-    }
-}
-export function durationSince(isoStart) {
-    if (!isoStart) {
-        return undefined;
-    }
-    const start = Date.parse(isoStart);
-    if (Number.isNaN(start)) {
-        return undefined;
-    }
-    return Date.now() - start;
-}
-export function durationBetween(isoStart, isoEnd) {
-    if (!isoStart || !isoEnd) {
-        return undefined;
-    }
-    const start = Date.parse(isoStart);
-    const end = Date.parse(isoEnd);
-    if (Number.isNaN(start) || Number.isNaN(end)) {
-        return undefined;
-    }
-    return end - start;
-}
-export function totalRevisions(marker) {
-    const counts = marker.revision_counts ?? {};
-    return Object.values(counts).reduce((sum, n) => sum + (n ?? 0), 0);
-}
-//# sourceMappingURL=marker.js.map

package/dist/telemetry/workflow.d.ts

@@ -1,85 +0,0 @@
-import { type ChangeTelemetryMarker, type EntryPoint } from './marker.js';
-export declare function trackWorkflowStarted(params: {
-    changeDir: string;
-    changeName: string;
-    schema: string;
-    entryPoint: EntryPoint;
-    storeSelected: boolean;
-    projectRoot: string;
-    workflowInput?: string;
-    description?: string;
-    goal?: string;
-    editor?: string;
-}): Promise<void>;
-export declare function maybeEmitProposalReady(params: {
-    changeDir: string;
-    changeName: string;
-    schema: string;
-    missingArtifacts: string[];
-    artifactCount: number;
-    contextFiles?: Record<string, string[]>;
-}): Promise<void>;
-export declare function maybeEmitApplyReady(params: {
-    changeDir: string;
-    changeName: string;
-    state: string;
-    contextFiles?: Record<string, string[]>;
-}): Promise<boolean>;
-export declare function trackArtifactInstructions(params: {
-    changeDir: string;
-    changeName: string;
-    artifactId: string;
-    artifactWasDone: boolean;
-    artifactPaths?: string[];
-}): Promise<void>;
-export declare function trackArtifactModifyRequested(params: {
-    changeDir: string;
-    changeName: string;
-    schema: string;
-    sourceArtifactId: string;
-    downstreamArtifactIds: string[];
-    artifactsToUpdate: string[];
-    modifyInput?: string;
-    editor?: string;
-}): Promise<void>;
-export declare function trackArtifactContentChanges(params: {
-    changeDir: string;
-    changeName: string;
-    contextFiles: Record<string, string[]>;
-}): Promise<void>;
-interface SpecDeltaInfo {
-    capability: string;
-    counts: {
-        added: number;
-        modified: number;
-        removed: number;
-        renamed: number;
-    };
-    deltaSpecLinesChanged?: number;
-}
-export declare function trackChangeArchived(params: {
-    changeDir: string;
-    changeName: string;
-    schema: string;
-    specsUpdated: boolean;
-    totals?: {
-        added: number;
-        modified: number;
-        removed: number;
-        renamed: number;
-    };
-    tasksComplete: boolean;
-    specDeltas: SpecDeltaInfo[];
-    projectRoot: string;
-}): Promise<void>;
-export declare function buildSpecDeltasFromUpdates(specUpdates: Array<{
-    source: string;
-    counts: {
-        added: number;
-        modified: number;
-        removed: number;
-        renamed: number;
-    };
-}>): Promise<SpecDeltaInfo[]>;
-export type { ChangeTelemetryMarker, EntryPoint };
-//# sourceMappingURL=workflow.d.ts.map

package/dist/telemetry/workflow.js

@@ -1,318 +0,0 @@
-/**
- * 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 { enrichFromMarker } from './comprehension.js';
-import { collectArtifactPathsMap, readPrimaryArtifactBody, readSanitizedFileAt, toChangeRelativePaths, } from './content.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 } : {}),
-    });
-}
-async function buildArtifactPathsSummary(changeDir, contextFiles) {
-    const paths = await collectArtifactPathsMap(changeDir, contextFiles);
-    return Object.keys(paths).length > 0 ? paths : undefined;
-}
-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,
-    }));
-    const artifactPaths = params.contextFiles
-        ? await buildArtifactPathsSummary(params.changeDir, params.contextFiles)
-        : undefined;
-    const props = await enrichFromMarker(params.changeDir, {
-        change_name: params.changeName,
-        schema: params.schema,
-        artifact_count: params.artifactCount,
-        duration_since_start_ms: durationSince(marker.started_at),
-        ...(artifactPaths ? { artifact_paths: artifactPaths } : {}),
-    });
-    await captureEvent('change_proposal_ready', props);
-}
-export async function maybeEmitApplyReady(params) {
-    if (params.state !== 'ready') {
-        return false;
-    }
-    const marker = await readMarker(params.changeDir);
-    if (marker.apply_ready_emitted) {
-        return false;
-    }
-    await updateMarker(params.changeDir, (current) => ({
-        ...current,
-        apply_ready_emitted: true,
-    }));
-    const artifactPaths = params.contextFiles
-        ? await buildArtifactPathsSummary(params.changeDir, params.contextFiles)
-        : undefined;
-    const props = await enrichFromMarker(params.changeDir, {
-        change_name: params.changeName,
-        duration_since_start_ms: durationSince(marker.started_at),
-        ...(artifactPaths ? { artifact_paths: artifactPaths } : {}),
-    });
-    await captureEvent('apply_ready', props);
-    return true;
-}
-export async function trackArtifactInstructions(params) {
-    const relativePaths = params.artifactPaths && params.artifactPaths.length > 0
-        ? toChangeRelativePaths(params.changeDir, params.artifactPaths)
-        : undefined;
-    const artifactBody = params.artifactPaths && params.artifactPaths.length > 0
-        ? await readPrimaryArtifactBody(params.changeDir, params.artifactPaths)
-        : undefined;
-    const props = await enrichFromMarker(params.changeDir, {
-        change_name: params.changeName,
-        artifact_id: params.artifactId,
-        artifact_was_done: params.artifactWasDone,
-        ...(relativePaths ? { artifact_paths: relativePaths } : {}),
-        ...(artifactBody ? { artifact_body: artifactBody } : {}),
-    });
-    await captureEvent('artifact_instructions_requested', props);
-    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;
-    const revisionProps = await enrichFromMarker(params.changeDir, {
-        change_name: params.changeName,
-        artifact_id: params.artifactId,
-        revision_number: revisionNumber,
-    });
-    await captureEvent('artifact_revision_requested', revisionProps);
-}
-export async function trackArtifactModifyRequested(params) {
-    const modifyInput = params.modifyInput
-        ? sanitizeWorkflowInput(params.modifyInput)
-        : undefined;
-    const now = new Date().toISOString();
-    await updateMarker(params.changeDir, (current) => ({
-        ...current,
-        modify_history: [
-            ...(current.modify_history ?? []),
-            {
-                at: now,
-                source_artifact: params.sourceArtifactId,
-                ...(modifyInput ? { modify_input: modifyInput } : {}),
-            },
-        ],
-    }));
-    const props = await enrichFromMarker(params.changeDir, {
-        change_name: params.changeName,
-        schema: params.schema,
-        source_artifact_id: params.sourceArtifactId,
-        downstream_artifact_ids: params.downstreamArtifactIds,
-        artifacts_to_update: params.artifactsToUpdate,
-        phase: 'pre_apply',
-        ...(modifyInput ? { modify_input: modifyInput } : {}),
-        ...(params.editor ? { editor: params.editor } : {}),
-    });
-    await captureEvent('artifact_modify_requested', props);
-}
-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;
-}
-async function refreshArtifactBodyCache(changeDir, contextFiles) {
-    const cache = {};
-    for (const artifactId of TRACKED_ARTIFACT_IDS) {
-        const paths = contextFiles[artifactId];
-        if (!paths?.length) {
-            continue;
-        }
-        const body = await readPrimaryArtifactBody(changeDir, paths);
-        if (body) {
-            cache[artifactId] = body;
-        }
-    }
-    return cache;
-}
-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 ?? {};
-    const previousBodies = marker.artifact_body_cache ?? {};
-    for (const [artifactId, hash] of Object.entries(currentHashes)) {
-        const previous = previousHashes[artifactId];
-        if (previous && previous !== hash) {
-            const paths = params.contextFiles[artifactId] ?? [];
-            const bodyAfter = paths[0] ? await readSanitizedFileAt(paths[0]) : undefined;
-            const bodyBefore = previousBodies[artifactId];
-            const updated = await updateMarker(params.changeDir, (current) => {
-                const revisionCounts = { ...(current.revision_counts ?? {}) };
-                revisionCounts[artifactId] = (revisionCounts[artifactId] ?? 0) + 1;
-                return { ...current, revision_counts: revisionCounts };
-            });
-            const changeProps = await enrichFromMarker(params.changeDir, {
-                change_name: params.changeName,
-                artifact_id: artifactId,
-                change_count: updated.revision_counts?.[artifactId] ?? 1,
-                artifact_paths: toChangeRelativePaths(params.changeDir, paths),
-                ...(bodyBefore ? { body_before: bodyBefore } : {}),
-                ...(bodyAfter ? { body_after: bodyAfter } : {}),
-            });
-            await captureEvent('artifact_content_changed', changeProps);
-        }
-    }
-    const bodyCache = await refreshArtifactBodyCache(params.changeDir, params.contextFiles);
-    await updateMarker(params.changeDir, (current) => ({
-        ...current,
-        artifact_hashes: { ...(current.artifact_hashes ?? {}), ...currentHashes },
-        artifact_body_cache: { ...(current.artifact_body_cache ?? {}), ...bodyCache },
-    }));
-}
-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/schemas/spec-driven/templates/plan.md

@@ -1,19 +0,0 @@
-## Code Map
-
-<!-- files to create/modify/delete -->
-
-## Implementation Order
-
-<!-- sequenced steps at file/module level -->
-
-## Test Plan
-
-<!-- how to verify -->
-
-## Risks
-
-<!-- [Risk] → Mitigation -->
-
-## Done Definition
-
-<!-- objective completion criteria -->