gmc-openspec 1.4.2 → 1.4.4

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/jira.js

@@ -111,6 +111,7 @@ export function registerJiraCommand(program) {
                 issueDir: intakeResult.issueDir,
                 intakePath: intakeResult.path,
                 status,
+                documentLanguage: intakeResult.intake?.documentLanguage,
                 allowedNext: status ? getAllowedNext(status) : [],
                 nextCommands: status ? getNextCommands(status, jiraId.toUpperCase()) : [],
                 blockingStage,

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/constants.d.ts

@@ -4,6 +4,8 @@ export declare const JIRA_CONFIG_VERSION = 1;
 export declare const JIRA_INTAKE_SCHEMA_VERSION = 1;
 export declare const JIRA_DEFAULT_PROVIDER = "atlassian-rovo";
 export declare const JIRA_DEFAULT_ENDPOINT = "https://mcp.atlassian.com/v1/mcp/authv2";
+export declare const JIRA_DOCUMENT_LANGUAGES: readonly ["en", "zh-CN"];
+export type JiraDocumentLanguage = (typeof JIRA_DOCUMENT_LANGUAGES)[number];
 export declare const JIRA_WORKFLOW_IDS: readonly ["jira-import", "jira-refine", "jira-review", "jira-split", "jira-propose", "jira-sync"];
 export type JiraWorkflowId = (typeof JIRA_WORKFLOW_IDS)[number];
 export declare const JIRA_WORKFLOW_TO_SKILL_DIR: Record<JiraWorkflowId, string>;

package/dist/core/jira/constants.js

@@ -4,6 +4,7 @@ export const JIRA_CONFIG_VERSION = 1;
 export const JIRA_INTAKE_SCHEMA_VERSION = 1;
 export const JIRA_DEFAULT_PROVIDER = 'atlassian-rovo';
 export const JIRA_DEFAULT_ENDPOINT = 'https://mcp.atlassian.com/v1/mcp/authv2';
+export const JIRA_DOCUMENT_LANGUAGES = ['en', 'zh-CN'];
 export const JIRA_WORKFLOW_IDS = [
     'jira-import',
     'jira-refine',

package/dist/core/jira/intake.d.ts

@@ -13,6 +13,10 @@ export declare const JiraIntakeSchema: z.ZodObject<{
         proposed: "proposed";
         synced: "synced";
     }>>;
+    documentLanguage: z.ZodDefault<z.ZodEnum<{
+        en: "en";
+        "zh-CN": "zh-CN";
+    }>>;
     sourceHashSha256: z.ZodOptional<z.ZodString>;
     allowedNext: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         split: "split";

package/dist/core/jira/intake.js

@@ -2,13 +2,14 @@ import { existsSync, readFileSync } from 'fs';
 import path from 'path';
 import { parse as parseYaml } from 'yaml';
 import { z } from 'zod';
-import { JIRA_ALLOWED_NEXT, JIRA_INTAKE_SCHEMA_VERSION, JIRA_STATUS_ORDER, } from './constants.js';
+import { JIRA_ALLOWED_NEXT, JIRA_DOCUMENT_LANGUAGES, JIRA_INTAKE_SCHEMA_VERSION, JIRA_STATUS_ORDER, } from './constants.js';
 import { getJiraIssueDir, normalizeJiraId } from './paths.js';
 export const JiraIntakeSchema = z
     .object({
     schemaVersion: z.number().int().positive().default(JIRA_INTAKE_SCHEMA_VERSION),
     jira: z.string().min(1),
     status: z.enum(JIRA_STATUS_ORDER).default('imported'),
+    documentLanguage: z.enum(JIRA_DOCUMENT_LANGUAGES).default('en'),
     sourceHashSha256: z.string().optional(),
     allowedNext: z.array(z.enum(JIRA_STATUS_ORDER)).optional(),
 })

package/dist/core/jira/templates.js

@@ -5,6 +5,8 @@ const SHARED_GUARDRAILS = `
 - Treat Jira as the business input source, not the final engineering specification.
 - Never create or modify \`openspec/changes/*\` directly from raw Jira description or comments.
 - Never modify \`source.md\`; it is a read-only Jira snapshot protected by \`sourceHashSha256\` in \`intake.yaml\`.
+- Use \`intake.yaml\` \`documentLanguage\` for generated prose documents: \`en\` means English and \`zh-CN\` means Simplified Chinese.
+- Keep structured YAML fields, status enum values, mapping keys, story IDs, requirement IDs, and traceability keys as stable English/code values regardless of \`documentLanguage\`.
 - Blocking questions must be answered before requirements can be marked reviewed.
 - Assumptions must be explicit in \`assumptions.md\` and approved before story split or OpenSpec proposal.
 - Keep \`mapping.yaml\` current so Jira AC maps to requirements, stories, and OpenSpec changes.
@@ -28,13 +30,16 @@ ${SHARED_GUARDRAILS}
    - Read summary, description, acceptance criteria, comments, linked issues, labels, components, and attachments metadata where available.
    - Use \`getJiraIssueRemoteIssueLinks\` and \`searchJiraIssuesUsingJql\` only when linked issues or related ticket lookup is needed.
    - Do not write to Jira.
-2. Create \`jira/<JIRA-ID>-<slug>/\` using a short slug from the Jira summary.
-3. Write \`source.md\` as an auditable snapshot with field names and source sections.
-4. Compute SHA-256 of \`source.md\` and write \`intake.yaml\`:
-   \`schemaVersion: 1\`, \`jira\`, \`status: imported\`, \`sourceHashSha256\`.
-5. Write \`requirement-draft.md\` as a concise product requirement draft.
-6. Write initial \`questions.md\`, \`assumptions.md\`, and \`mapping.yaml\` placeholders.
-7. Run \`openspec jira validate <JIRA-ID> --stage source\` and report the result.
+2. Ask the user which document language to use for subsequent generated documents: English or Simplified Chinese. Default to English when the user has no preference.
+   - Record English as \`documentLanguage: en\`.
+   - Record Simplified Chinese as \`documentLanguage: zh-CN\`.
+3. Create \`jira/<JIRA-ID>-<slug>/\` using a short slug from the Jira summary.
+4. Write \`source.md\` as an auditable snapshot with field names and source sections. Preserve the original Jira text and do not translate \`source.md\`.
+5. Compute SHA-256 of \`source.md\` and write \`intake.yaml\`:
+   \`schemaVersion: 1\`, \`jira\`, \`status: imported\`, \`documentLanguage\`, \`sourceHashSha256\`.
+6. Write \`requirement-draft.md\` as a concise product requirement draft using \`documentLanguage\`.
+7. Write initial \`questions.md\` and \`assumptions.md\` using \`documentLanguage\`, plus \`mapping.yaml\` placeholders with stable English/code keys.
+8. Run \`openspec jira validate <JIRA-ID> --stage source\` and report the result.
 
 ## Output
 
@@ -52,14 +57,14 @@ ${SHARED_GUARDRAILS}
 
 ## Steps
 
-1. Run \`openspec jira status <JIRA-ID> --json\` and read the intake folder.
+1. Run \`openspec jira status <JIRA-ID> --json\` and read the intake folder, including \`intake.yaml\` \`documentLanguage\`.
 2. Read \`source.md\`, \`requirement-draft.md\`, \`questions.md\`, \`assumptions.md\`, and \`mapping.yaml\`.
 3. Identify ambiguity as either:
    - **Blocking**: affects scope, AC, permissions, data contract, external behavior, or story boundaries.
    - **Non-Blocking**: can be captured as an explicit assumption.
-4. Ask the user all blocking questions before proceeding. Update \`questions.md\` with statuses.
-5. Record non-blocking assumptions in \`assumptions.md\`; do not hide assumptions in requirement prose.
-6. When blocking questions are resolved, write \`requirement.md\` and set \`intake.yaml\` status to \`ready-for-review\`.
+4. Ask the user all blocking questions before proceeding. Update \`questions.md\` with statuses using \`documentLanguage\`.
+5. Record non-blocking assumptions in \`assumptions.md\` using \`documentLanguage\`; do not hide assumptions in requirement prose.
+6. When blocking questions are resolved, write \`requirement.md\` using \`documentLanguage\` and set \`intake.yaml\` status to \`ready-for-review\`.
 7. Run \`openspec jira validate <JIRA-ID> --stage requirement\`.
 
 ## Output
@@ -78,7 +83,7 @@ ${SHARED_GUARDRAILS}
 
 ## Steps
 
-1. Read \`requirement.md\`, \`questions.md\`, and \`assumptions.md\`.
+1. Read \`intake.yaml\` to get \`documentLanguage\`, then read \`requirement.md\`, \`questions.md\`, and \`assumptions.md\`.
 2. Run \`openspec jira validate <JIRA-ID> --stage requirement --json\`.
 3. If validation fails, explain the blockers and return to \`/opsx:jira-refine\`.
 4. Ask the user to approve or request edits to the requirement and assumptions.
@@ -105,8 +110,8 @@ Each story must have independent review value, clear AC, scope, non-goals, depen
 ## Steps
 
 1. Run \`openspec jira validate <JIRA-ID> --stage requirement --json\`.
-2. Read \`requirement.md\`, \`mapping.yaml\`, and existing OpenSpec specs if capability choices are unclear.
-3. Write \`stories.md\` with story ids, titles, scope, non-goals, AC, dependencies, risks, and suggested OpenSpec change names.
+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.
 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\`.
@@ -128,13 +133,13 @@ ${SHARED_GUARDRAILS}
 ## Steps
 
 1. Run \`openspec jira validate <JIRA-ID> --stage stories --json\`. Stop if it fails.
-2. Read \`stories.md\`, \`mapping.yaml\`, and \`requirement.md\`.
+2. Read \`intake.yaml\` to get \`documentLanguage\`, plus \`stories.md\`, \`mapping.yaml\`, and \`requirement.md\`.
 3. For each non-deferred reviewed story, create exactly one OpenSpec change:
    \`openspec new change <jira-id>-<story-slug>\`.
 4. Generate artifacts through the existing OpenSpec flow:
    - Run \`openspec status --change <change> --json\`.
    - For each ready artifact, run \`openspec instructions <artifact> --change <change> --json\`.
-   - Create \`proposal.md\`, delta specs, \`design.md\`, and \`tasks.md\` from the reviewed story and requirement, not raw Jira text.
+   - Create \`proposal.md\`, delta specs, \`design.md\`, and \`tasks.md\` using \`documentLanguage\` from the reviewed story and requirement, not raw Jira text.
 5. Update \`mapping.yaml\` so every story records its OpenSpec change and spec files.
 6. Set \`intake.yaml\` status to \`proposed\` and run \`openspec jira validate <JIRA-ID> --stage propose\`.
 

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.2",
+  "version": "1.4.4",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",