gmc-openspec 1.4.3 → 1.4.5

package/dist/cli/index.js

@@ -4,7 +4,7 @@ import ora from 'ora';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { promises as fs } from 'fs';
-import { AI_TOOLS } from '../core/config.js';
+import { AI_TOOLS, OPENSPEC_DIR_NAME } from '../core/config.js';
 import { UpdateCommand } from '../core/update.js';
 import { ListCommand } from '../core/list.js';
 import { ArchiveCommand } from '../core/archive.js';
@@ -17,7 +17,7 @@ import { CompletionCommand } from '../commands/completion.js';
 import { FeedbackCommand } from '../commands/feedback.js';
 import { registerConfigCommand } from '../commands/config.js';
 import { registerSchemaCommand } from '../commands/schema.js';
-import { registerWorkspaceCommand, runWorkspaceUpdateForRoot, } from '../commands/workspace.js';
+import { registerWorkspaceCommand } from '../commands/workspace.js';
 import { registerContextStoreCommand } from '../commands/context-store.js';
 import { registerInitiativeCommand } from '../commands/initiative.js';
 import { findWorkspaceRoot } from '../core/workspace/index.js';
@@ -71,6 +71,21 @@ program.hook('postAction', async () => {
 });
 const availableToolIds = AI_TOOLS.filter((tool) => tool.skillsDir).map((tool) => tool.value);
 const toolsOptionDescription = `Configure AI tools non-interactively. Use "all", "none", or a comma-separated list of: ${availableToolIds.join(', ')}`;
+async function hasRepoLocalOpenSpecProject(projectPath) {
+    try {
+        const stats = await fs.stat(path.join(projectPath, OPENSPEC_DIR_NAME));
+        return stats.isDirectory();
+    }
+    catch (error) {
+        const code = typeof error === 'object' && error !== null && 'code' in error
+            ? error.code
+            : undefined;
+        if (code !== 'ENOENT' && code !== 'ENOTDIR') {
+            throw error;
+        }
+        return false;
+    }
+}
 program
     .command('init [path]')
     .description('Initialize OpenSpec in your project')
@@ -142,12 +157,15 @@ program
     .action(async (targetPath = '.', options) => {
     try {
         const resolvedPath = path.resolve(targetPath);
+        const updateCommand = new UpdateCommand({ force: options?.force });
+        if (await hasRepoLocalOpenSpecProject(resolvedPath)) {
+            await updateCommand.execute(resolvedPath);
+            return;
+        }
         const workspaceRoot = await findWorkspaceRoot(resolvedPath);
         if (workspaceRoot) {
-            await runWorkspaceUpdateForRoot(workspaceRoot, { force: options?.force });
-            return;
+            throw new Error('OpenSpec workspace detected. Run `openspec workspace update` to refresh workspace-local guidance and skills.');
         }
-        const updateCommand = new UpdateCommand({ force: options?.force });
         await updateCommand.execute(resolvedPath);
     }
     catch (error) {

package/dist/commands/workspace/context-status.js

@@ -25,7 +25,7 @@ export async function collectWorkspaceContextStatuses(context) {
                 target: 'workspace.context.store',
                 fix: context.store.selector.kind === 'registry'
                     ? 'openspec context-store doctor'
-                    : `Check the path in workspace.yaml or run openspec initiative show ${initiativeId} ${selector}`,
+                    : `Check the path in .openspec-workspace/view.yaml or run openspec initiative show ${initiativeId} ${selector}`,
             }),
         ];
     }

package/dist/commands/workspace/open-view.js

@@ -84,7 +84,7 @@ async function resolveStoredWorkspaceInitiative(context) {
             target: 'workspace.context.store',
             fix: context.store.selector.kind === 'registry'
                 ? 'openspec context-store doctor'
-                : 'Check the path in workspace.yaml.',
+                : 'Check the path in .openspec-workspace/view.yaml.',
         });
     }
 }

package/dist/commands/workspace/operations.js

@@ -114,7 +114,7 @@ export function validateLinkNameForCommand(name) {
 function localStateInvalidStatus(error) {
     return makeStatus('error', 'workspace_local_state_invalid', `Machine-local paths could not be read: ${asErrorMessage(error)}`, {
         target: 'workspace.local_state',
-        fix: 'Repair workspace.yaml, then run openspec workspace relink <name> <path> for affected links.',
+        fix: 'Repair .openspec-workspace/view.yaml, then run openspec workspace relink <name> <path> for affected links.',
     });
 }
 function workspaceSkillDriftStatus(workspaceName) {
@@ -279,7 +279,7 @@ export async function loadWorkspaceForDoctor(selected) {
                 status: [
                     makeStatus('error', 'workspace_state_invalid', `Workspace state could not be read: ${asErrorMessage(error)}`, {
                         target: 'workspace.root',
-                        fix: 'Repair .openspec-workspace/workspace.yaml before using this workspace.',
+                        fix: 'Repair .openspec-workspace/view.yaml before using this workspace.',
                     }),
                 ],
             },
@@ -345,7 +345,7 @@ async function readWorkspaceViewForMutation(selected) {
     catch (error) {
         throw new WorkspaceCliError(`Workspace state could not be read: ${asErrorMessage(error)}`, 'workspace_state_invalid', {
             target: 'workspace.state',
-            fix: 'Repair workspace.yaml before using this workspace.',
+            fix: 'Repair .openspec-workspace/view.yaml before using this workspace.',
         });
     }
 }

package/dist/commands/workspace/selection.d.ts

@@ -2,7 +2,6 @@ import { type WorkspaceRegistryEntry } from '../../core/workspace/index.js';
 import { SelectedWorkspace, WorkspaceSelectionOptions } from './types.js';
 export declare function selectedWorkspaceFromEntry(entry: WorkspaceRegistryEntry): SelectedWorkspace;
 export declare function selectedWorkspaceFromRoot(currentWorkspaceRoot: string, entries: WorkspaceRegistryEntry[]): Promise<SelectedWorkspace>;
-export declare function selectWorkspaceRootForCommand(workspaceRoot: string): Promise<SelectedWorkspace>;
 export declare function selectWorkspaceForCommand(options: WorkspaceSelectionOptions, commandName: string, selectionOptions?: {
     preferPositionalName?: boolean;
 }): Promise<SelectedWorkspace>;

package/dist/commands/workspace/selection.js

@@ -44,17 +44,6 @@ export async function selectedWorkspaceFromRoot(currentWorkspaceRoot, entries) {
         unregisteredCurrentWorkspace: !isKnown,
     };
 }
-export async function selectWorkspaceRootForCommand(workspaceRoot) {
-    const entries = await listKnownWorkspaceEntries();
-    const currentWorkspaceRoot = await findWorkspaceRoot(workspaceRoot);
-    if (!currentWorkspaceRoot) {
-        throw new WorkspaceCliError(`No OpenSpec workspace found at '${workspaceRoot}'.`, 'workspace_not_found', {
-            target: 'workspace.root',
-            fix: 'Pass a path inside an OpenSpec workspace.',
-        });
-    }
-    return selectedWorkspaceFromRoot(currentWorkspaceRoot, entries);
-}
 export async function selectWorkspaceForCommand(options, commandName, selectionOptions = {}) {
     const entries = await listKnownWorkspaceEntries();
     if (options.workspace) {

package/dist/commands/workspace.d.ts

@@ -1,6 +1,5 @@
 import { Command } from 'commander';
 import { WorkspaceUpdateOptions } from './workspace/types.js';
 export declare function runWorkspaceUpdate(positionalName: string | undefined, options?: WorkspaceUpdateOptions): Promise<void>;
-export declare function runWorkspaceUpdateForRoot(workspaceRoot: string, options?: WorkspaceUpdateOptions): Promise<void>;
 export declare function registerWorkspaceCommand(program: Command): void;
 //# sourceMappingURL=workspace.d.ts.map

package/dist/commands/workspace.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import { createWorkspaceSkillSkippedReport, generateWorkspaceAgentSkills, getWorkspaceSkillCapableTools, getWorkspaceSkillToolIds, getWorkspaceOpenerLabel, parseWorkspaceSkillToolsValue, updateWorkspaceAgentSkills, listKnownWorkspaceEntries, readWorkspaceViewState, syncWorkspaceOpenSurface, writeWorkspaceViewState, } from '../core/workspace/index.js';
 import { isInteractive, resolveNoInteractive } from '../utils/interactive.js';
 import { addWorkspaceLink, createManagedWorkspace, loadWorkspaceForDoctor, loadWorkspaceForList, parseSetupLinks, readWorkspaceForMutation, updateWorkspaceLink, validateWorkspaceNameForSetup, } from './workspace/operations.js';
-import { selectWorkspaceForCommand, selectWorkspaceRootForCommand, } from './workspace/selection.js';
+import { selectWorkspaceForCommand } from './workspace/selection.js';
 import { launchWorkspaceOpenCommand, } from './workspace/open.js';
 import { buildWorkspaceOpenJsonPayload, prepareWorkspaceOpen, } from './workspace/open-view.js';
 import { getPreferredWorkspaceSkillAgentId, parseSetupOpenerOption, promptPreferredOpener, } from './workspace/opener-selection.js';
@@ -484,15 +484,6 @@ class WorkspaceCommand {
             this.handleFailure(options.json, { workspace: null, workspace_skills: null, status: [] }, error);
         }
     }
-    async updateRoot(workspaceRoot, options = {}) {
-        try {
-            const selected = await selectWorkspaceRootForCommand(workspaceRoot);
-            await this.updateSelected(selected, options);
-        }
-        catch (error) {
-            this.handleFailure(options.json, { workspace: null, workspace_skills: null, status: [] }, error);
-        }
-    }
     async updateSelected(selected, options) {
         const viewState = await readWorkspaceForMutation(selected);
         await syncWorkspaceOpenSurface(selected.root, viewState);
@@ -577,10 +568,6 @@ export async function runWorkspaceUpdate(positionalName, options = {}) {
     const workspaceCommand = new WorkspaceCommand();
     await workspaceCommand.update(positionalName, options);
 }
-export async function runWorkspaceUpdateForRoot(workspaceRoot, options = {}) {
-    const workspaceCommand = new WorkspaceCommand();
-    await workspaceCommand.updateRoot(workspaceRoot, options);
-}
 export function registerWorkspaceCommand(program) {
     registerWorkspaceCommandWith(program, new WorkspaceCommand());
 }

package/dist/core/jira/templates.js

@@ -107,11 +107,18 @@ ${SHARED_GUARDRAILS}
 
 Each story must have independent review value, clear AC, scope, non-goals, dependencies, and a traceable requirement source. Avoid one giant change and avoid tiny implementation-only fragments.
 
+## Story Title Format
+
+- In \`stories.md\`, each story heading/title MUST include a split marker in \`[S-x]\` form, using the story sequence visible to reviewers, for example \`## [S-1] Add refund endpoint\`.
+- If the affected repository is known from Jira fields, requirement text, workspace context, or existing mapping, include the short repository abbreviation in bracket form before the story marker, for example \`## [api] [S-1] Add refund endpoint\`.
+- For multi-repo stories, include each known repository abbreviation as its own bracket, for example \`## [web] [api] [S-2] Wire checkout status\`.
+- If the affected repository cannot be determined with confidence, omit the repo bracket instead of inventing one.
+
 ## Steps
 
 1. Run \`openspec jira validate <JIRA-ID> --stage requirement --json\`.
 2. Read \`intake.yaml\` to get \`documentLanguage\`, plus \`requirement.md\`, \`mapping.yaml\`, and existing OpenSpec specs if capability choices are unclear.
-3. Write \`stories.md\` using \`documentLanguage\`, with stable English/code story ids, titles, scope, non-goals, AC, dependencies, risks, and suggested OpenSpec change names.
+3. Write \`stories.md\` using \`documentLanguage\`, with stable English/code story ids, titles following the Story Title Format, scope, non-goals, AC, dependencies, risks, and suggested OpenSpec change names.
 4. Update \`mapping.yaml\` so every Jira AC maps to at least one story.
 5. Set \`intake.yaml\` status to \`split\` and ask the user to review the story split.
 6. After explicit user approval, set status to \`stories-reviewed\` and run \`openspec jira validate <JIRA-ID> --stage stories\`.

package/dist/core/workspace/foundation.d.ts

@@ -1,6 +1,6 @@
 import { type ContextStoreBinding, type ContextStoreSelector } from '../context-store/index.js';
 export declare const WORKSPACE_METADATA_DIR_NAME = ".openspec-workspace";
-export declare const WORKSPACE_VIEW_STATE_FILE_NAME = "workspace.yaml";
+export declare const WORKSPACE_VIEW_STATE_FILE_NAME = "view.yaml";
 export declare const WORKSPACE_CHANGES_DIR_NAME = "changes";
 export declare const WORKSPACE_CODE_WORKSPACE_EXTENSION = ".code-workspace";
 export declare const WORKSPACE_SUPPORTED_OPENER_VALUES: readonly ["codex-cli", "claude", "github-copilot", "editor"];

package/dist/core/workspace/foundation.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 import { normalizeContextStoreBinding, } from '../context-store/index.js';
 import { FileSystemUtils } from '../../utils/file-system.js';
 export const WORKSPACE_METADATA_DIR_NAME = '.openspec-workspace';
-export const WORKSPACE_VIEW_STATE_FILE_NAME = 'workspace.yaml';
+export const WORKSPACE_VIEW_STATE_FILE_NAME = 'view.yaml';
 export const WORKSPACE_CHANGES_DIR_NAME = 'changes';
 export const WORKSPACE_CODE_WORKSPACE_EXTENSION = '.code-workspace';
 export const WORKSPACE_SUPPORTED_OPENER_VALUES = [
@@ -25,7 +25,7 @@ export function getWorkspaceMetadataDir(workspaceRoot) {
     return joinWorkspacePath(workspaceRoot, WORKSPACE_METADATA_DIR_NAME);
 }
 export function getWorkspaceViewStatePath(workspaceRoot) {
-    return joinWorkspacePath(workspaceRoot, WORKSPACE_VIEW_STATE_FILE_NAME);
+    return joinWorkspacePath(getWorkspaceMetadataDir(workspaceRoot), WORKSPACE_VIEW_STATE_FILE_NAME);
 }
 export function getWorkspaceChangesDir(workspaceRoot) {
     return joinWorkspacePath(workspaceRoot, WORKSPACE_CHANGES_DIR_NAME);

package/dist/core/workspace/legacy-state.js

@@ -1,8 +1,8 @@
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 import { z } from 'zod';
-import { WORKSPACE_METADATA_DIR_NAME, WORKSPACE_VIEW_STATE_FILE_NAME, getWorkspaceMetadataDir, parseWorkspaceViewState, validateWorkspaceLinkName, validateWorkspaceName, validateWorkspacePreferredOpener, } from './foundation.js';
+import { WORKSPACE_METADATA_DIR_NAME, getWorkspaceMetadataDir, parseWorkspaceViewState, validateWorkspaceLinkName, validateWorkspaceName, validateWorkspacePreferredOpener, } from './foundation.js';
 import { FileSystemUtils } from '../../utils/file-system.js';
-export const WORKSPACE_LEGACY_SHARED_STATE_FILE_NAME = WORKSPACE_VIEW_STATE_FILE_NAME;
+export const WORKSPACE_LEGACY_SHARED_STATE_FILE_NAME = 'workspace.yaml';
 export const WORKSPACE_LEGACY_LOCAL_STATE_FILE_NAME = 'local.yaml';
 export const WORKSPACE_LEGACY_LOCAL_STATE_IGNORE_PATTERN = `${WORKSPACE_METADATA_DIR_NAME}/${WORKSPACE_LEGACY_LOCAL_STATE_FILE_NAME}`;
 function joinWorkspacePath(basePath, ...segments) {

package/dist/core/workspace/open-surface.d.ts

@@ -3,7 +3,7 @@ export declare const WORKSPACE_GUIDANCE_START_MARKER = "<!-- OPENSPEC:WORKSPACE-
 export declare const WORKSPACE_GUIDANCE_END_MARKER = "<!-- OPENSPEC:WORKSPACE-GUIDANCE:END -->";
 export declare const WORKSPACE_OPEN_ROOT_FOLDER_LABEL = "OpenSpec workspace";
 export declare const WORKSPACE_OPEN_INITIATIVE_FOLDER_LABEL = "Initiative context";
-export declare const WORKSPACE_GUIDANCE_BODY = "# OpenSpec Workspace Guidance\n\nThis directory is an OpenSpec workspace: a local working view over context stores, initiatives, repos, and folders.\n\n- Use this workspace to open the local view of coordinated work.\n- Use initiatives for durable cross-team or cross-repo intent, decisions, requirements, and coordination context.\n- Use repo-local OpenSpec changes for implementation plans owned by a repo or team.\n- Use linked repos and folders to inspect context, understand ownership, and make edits in the place that owns the work.\n- Keep workspace-local files focused on local paths, opener state, agent setup, and other machine-specific view state.\n- Use OpenSpec workspace commands instead of hand-editing `workspace.yaml`.\n- If this workspace contains legacy or beta workspace-level planning files, treat them as compatibility context unless the user explicitly asks to use that beta flow.";
+export declare const WORKSPACE_GUIDANCE_BODY = "# OpenSpec Workspace Guidance\n\nThis directory is an OpenSpec workspace: a local working view over context stores, initiatives, repos, and folders.\n\n- Use this workspace to open the local view of coordinated work.\n- Use initiatives for durable cross-team or cross-repo intent, decisions, requirements, and coordination context.\n- Use repo-local OpenSpec changes for implementation plans owned by a repo or team.\n- Use linked repos and folders to inspect context, understand ownership, and make edits in the place that owns the work.\n- Keep workspace-local files focused on local paths, opener state, agent setup, and other machine-specific view state.\n- Use OpenSpec workspace commands instead of hand-editing `.openspec-workspace/view.yaml`.\n- If this workspace contains legacy or beta workspace-level planning files, treat them as compatibility context unless the user explicitly asks to use that beta flow.";
 export interface WorkspaceOpenResolvedContext {
     contextStore: {
         id: string;

package/dist/core/workspace/open-surface.js

@@ -16,7 +16,7 @@ This directory is an OpenSpec workspace: a local working view over context store
 - Use repo-local OpenSpec changes for implementation plans owned by a repo or team.
 - Use linked repos and folders to inspect context, understand ownership, and make edits in the place that owns the work.
 - Keep workspace-local files focused on local paths, opener state, agent setup, and other machine-specific view state.
-- Use OpenSpec workspace commands instead of hand-editing \`workspace.yaml\`.
+- Use OpenSpec workspace commands instead of hand-editing \`.openspec-workspace/view.yaml\`.
 - If this workspace contains legacy or beta workspace-level planning files, treat them as compatibility context unless the user explicitly asks to use that beta flow.`;
 async function fileExists(filePath) {
     try {

package/dist/core/workspace/state-io.js

@@ -1,7 +1,7 @@
 import * as nodeFs from 'node:fs';
 import * as path from 'node:path';
 import { FileSystemUtils } from '../../utils/file-system.js';
-import { getWorkspaceChangesDir, getWorkspaceViewStatePath, parseWorkspaceViewState, serializeWorkspaceViewState, } from './foundation.js';
+import { getWorkspaceChangesDir, getWorkspaceMetadataDir, getWorkspaceViewStatePath, parseWorkspaceViewState, serializeWorkspaceViewState, } from './foundation.js';
 import { getWorkspaceLegacyLocalStatePath, getWorkspaceLegacySharedStatePath, parseWorkspaceLocalState, parseWorkspaceSharedState, workspaceStatePartsToViewState, } from './legacy-state.js';
 const fs = nodeFs.promises;
 async function pathIsFile(filePath) {
@@ -111,7 +111,9 @@ export async function readOptionalWorkspaceViewState(workspaceRoot) {
     }
 }
 export async function writeWorkspaceViewState(workspaceRoot, state) {
-    await FileSystemUtils.writeFile(getWorkspaceViewStatePath(workspaceRoot), serializeWorkspaceViewState(state));
+    const content = serializeWorkspaceViewState(state);
+    await FileSystemUtils.createDirectory(getWorkspaceMetadataDir(workspaceRoot));
+    await FileSystemUtils.writeFile(getWorkspaceViewStatePath(workspaceRoot), content);
 }
 export async function workspaceChangesDirExists(workspaceRoot) {
     return pathIsDirectory(getWorkspaceChangesDir(workspaceRoot));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gmc-openspec",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",