@niujiajie/freespec 0.0.0-stage → 1.15.0

package/dist/core/artifact-graph/types.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export declare const ArtifactSchema: z.ZodObject<{
+    id: z.ZodString;
+    generates: z.ZodString;
+    description: z.ZodString;
+    template: z.ZodString;
+    instruction: z.ZodOptional<z.ZodString>;
+    requires: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ApplyPhaseSchema: z.ZodObject<{
+    requires: z.ZodArray<z.ZodString>;
+    tracks: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    instruction: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SchemaYamlSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodNumber;
+    description: z.ZodOptional<z.ZodString>;
+    artifacts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        generates: z.ZodString;
+        description: z.ZodString;
+        template: z.ZodString;
+        instruction: z.ZodOptional<z.ZodString>;
+        requires: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    apply: z.ZodOptional<z.ZodObject<{
+        requires: z.ZodArray<z.ZodString>;
+        tracks: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        instruction: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Artifact = z.infer<typeof ArtifactSchema>;
+export type ApplyPhase = z.infer<typeof ApplyPhaseSchema>;
+export type SchemaYaml = z.infer<typeof SchemaYamlSchema>;
+export type CompletedSet = Set<string>;
+export interface BlockedArtifacts {
+    [artifactId: string]: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/artifact-graph/types.js

@@ -0,0 +1,59 @@
+import * as path from 'node:path';
+import { z } from 'zod';
+function relativePathSchema(fieldName) {
+    return z
+        .string()
+        .min(1, { error: `${fieldName} is required` })
+        .superRefine((value, ctx) => {
+        const segments = value.split(/[\\/]+/u);
+        const isDrivePath = /^[A-Za-z]:/u.test(value);
+        const isAbsolute = path.posix.isAbsolute(value) || path.win32.isAbsolute(value) || isDrivePath;
+        const escapes = segments.includes('..');
+        if (isAbsolute || escapes || value.includes('\0')) {
+            ctx.addIssue({
+                code: 'custom',
+                message: `${fieldName} must be a relative path inside its allowed directory`,
+            });
+        }
+    });
+}
+// Artifact definition schema
+// Upper bound on artifacts in one schema. Keeps `validateNoCycles`' recursive
+// DFS well inside the stack limit for any accepted input.
+const MAX_ARTIFACTS = 1000;
+export const ArtifactSchema = z.object({
+    id: z.string().min(1, { error: 'Artifact ID is required' }),
+    generates: relativePathSchema('generates field'),
+    description: z.string(),
+    template: relativePathSchema('template field'),
+    instruction: z.string().optional(),
+    requires: z.array(z.string()).default([]),
+});
+// Apply phase configuration for schema-aware apply instructions
+export const ApplyPhaseSchema = z.object({
+    // Artifact IDs that must exist before apply is available
+    // Empty means implementation is not blocked on any artifact file.
+    requires: z.array(z.string()),
+    // Path to file with checkboxes for progress (relative to change dir), or null if no tracking
+    tracks: relativePathSchema('apply.tracks').nullable().optional(),
+    // Custom guidance for the apply phase
+    instruction: z.string().optional(),
+});
+// Full schema YAML structure
+export const SchemaYamlSchema = z.object({
+    name: z.string().min(1, { error: 'Schema name is required' }),
+    version: z.number().int().positive({ error: 'Version must be a positive integer' }),
+    description: z.string().optional(),
+    artifacts: z
+        .array(ArtifactSchema)
+        .min(1, { error: 'At least one artifact required' })
+        // Bounded so a hostile schema cannot drive the cycle-detection DFS past the
+        // V8 stack limit and crash with an uncaught RangeError instead of a
+        // validation error.
+        .max(MAX_ARTIFACTS, {
+        error: `A schema may declare at most ${MAX_ARTIFACTS} artifacts`,
+    }),
+    // Optional apply phase configuration (for schema-aware apply instructions)
+    apply: ApplyPhaseSchema.optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/core/available-tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Available Tools Detection
+ *
+ * Detects which AI tools are available in a project by scanning
+ * for their configuration directories.
+ */
+import { type AIToolOption } from './config.js';
+import { type FileView } from './file-view.js';
+/**
+ * Scans the project path for AI tool configuration directories and returns
+ * the tools that are present.
+ *
+ * For tools with `detectionPaths`, checks those specific paths (files or
+ * directories). Otherwise checks the project's `skillsDir`, or managed skill
+ * files in the user's home directory for a global skill target.
+ */
+export declare function getAvailableTools(projectPath: string, view?: FileView): AIToolOption[];
+//# sourceMappingURL=available-tools.d.ts.map

package/dist/core/available-tools.js

@@ -0,0 +1,49 @@
+/**
+ * Available Tools Detection
+ *
+ * Detects which AI tools are available in a project by scanning
+ * for their configuration directories.
+ */
+import path from 'path';
+import { AI_TOOLS } from './config.js';
+import { reconcileSharedSkillTargets } from './shared-skill-target.js';
+import { SKILL_NAMES } from './shared/tool-detection.js';
+import { resolveToolSkillsDir, toolSupportsSkills } from './shared/skill-paths.js';
+import { DISK_VIEW } from './file-view.js';
+/**
+ * Scans the project path for AI tool configuration directories and returns
+ * the tools that are present.
+ *
+ * For tools with `detectionPaths`, checks those specific paths (files or
+ * directories). Otherwise checks the project's `skillsDir`, or managed skill
+ * files in the user's home directory for a global skill target.
+ */
+export function getAvailableTools(projectPath, view = DISK_VIEW) {
+    const available = AI_TOOLS.filter((tool) => {
+        if (!toolSupportsSkills(tool))
+            return false;
+        if (tool.globalSkillsDir) {
+            const skillsDir = resolveToolSkillsDir(projectPath, tool);
+            return SKILL_NAMES.some((skillName) => view.exists(path.join(skillsDir, skillName, 'SKILL.md')));
+        }
+        if (!tool.skillsDir)
+            return false;
+        if (tool.detectionPaths && tool.detectionPaths.length > 0) {
+            // Presence, not type — detection paths can be files or directories
+            return tool.detectionPaths.some((p) => view.exists(path.join(projectPath, p)));
+        }
+        return view.isDirectory(path.join(projectPath, tool.skillsDir));
+    });
+    const activeProjectTools = new Set(reconcileSharedSkillTargets(projectPath, available.filter((tool) => tool.skillsDir), view).map((tool) => tool.value));
+    const hasIndependentDetectionPath = (tool) => (tool.detectionPaths ?? []).some((detectionPath) => {
+        // Skill roots still go through managed-content reconciliation below;
+        // their mere existence is not an independent tool signal.
+        if (detectionPath.endsWith('/skills'))
+            return false;
+        return view.exists(path.join(projectPath, detectionPath));
+    });
+    return available.filter((tool) => tool.globalSkillsDir ||
+        hasIndependentDetectionPath(tool) ||
+        activeProjectTools.has(tool.value));
+}
+//# sourceMappingURL=available-tools.js.map

package/dist/core/change-layout.d.ts

@@ -0,0 +1,17 @@
+/** Default workflow schema. Artifacts are optional Chinese markdown files. */
+export declare const DEFAULT_SCHEMA = "\u9ED8\u8BA4";
+/** Every change folder is `freespec/<名称>变更/`. */
+export declare const CHANGE_FOLDER_SUFFIX = "\u53D8\u66F4";
+/**
+ * Parent of change folders. A change is a directory directly under `freespec/`
+ * whose name ends with `变更`.
+ */
+export declare function changeParentDir(projectRoot: string): string;
+/**
+ * Appends `变更` when the caller gave only the topic. `登录改造` and
+ * `登录改造变更` both become `登录改造变更`.
+ */
+export declare function normalizeChangeName(name: string): string;
+/** True for a directory name that is a change folder. */
+export declare function isChangeDirectoryName(name: string): boolean;
+//# sourceMappingURL=change-layout.d.ts.map

package/dist/core/change-layout.js

@@ -0,0 +1,30 @@
+import path from 'node:path';
+/** Default workflow schema. Artifacts are optional Chinese markdown files. */
+export const DEFAULT_SCHEMA = '默认';
+/** Every change folder is `freespec/<名称>变更/`. */
+export const CHANGE_FOLDER_SUFFIX = '变更';
+const CHANGE_NAME_BODY = '[\\u4e00-\\u9fff0-9]+';
+const CHANGE_NAME_PATTERN = new RegExp(`^${CHANGE_NAME_BODY}(?:-${CHANGE_NAME_BODY})*${CHANGE_FOLDER_SUFFIX}$`, 'u');
+/**
+ * Parent of change folders. A change is a directory directly under `freespec/`
+ * whose name ends with `变更`.
+ */
+export function changeParentDir(projectRoot) {
+    return path.join(projectRoot, 'freespec');
+}
+/**
+ * Appends `变更` when the caller gave only the topic. `登录改造` and
+ * `登录改造变更` both become `登录改造变更`.
+ */
+export function normalizeChangeName(name) {
+    const trimmed = name.trim();
+    if (!trimmed || trimmed.endsWith(CHANGE_FOLDER_SUFFIX)) {
+        return trimmed;
+    }
+    return `${trimmed}${CHANGE_FOLDER_SUFFIX}`;
+}
+/** True for a directory name that is a change folder. */
+export function isChangeDirectoryName(name) {
+    return CHANGE_NAME_PATTERN.test(name);
+}
+//# sourceMappingURL=change-layout.js.map

package/dist/core/change-metadata/index.d.ts

@@ -0,0 +1,2 @@
+export * from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/change-metadata/index.js

@@ -0,0 +1,2 @@
+export * from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/core/change-metadata/schema.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export { isKebabId } from '../id.js';
+export declare const InitiativeLinkSchema: z.ZodObject<{
+    store: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strict>;
+export type InitiativeLink = z.infer<typeof InitiativeLinkSchema>;
+/** Top-level keys ChangeMetadataSchema recognizes. Anything else is ignored. */
+export declare const CHANGE_METADATA_KNOWN_KEYS: readonly ["schema", "created", "goal", "affected_areas", "initiative", "retire_capabilities"];
+export type ChangeMetadataKnownKey = (typeof CHANGE_METADATA_KNOWN_KEYS)[number];
+export declare const ChangeMetadataSchema: z.ZodObject<{
+    schema: z.ZodString;
+    created: z.ZodOptional<z.ZodString>;
+    goal: z.ZodOptional<z.ZodString>;
+    affected_areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    initiative: z.ZodOptional<z.ZodObject<{
+        store: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>>;
+    retire_capabilities: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ChangeMetadata = z.infer<typeof ChangeMetadataSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/change-metadata/schema.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { isKebabId } from '../id.js';
+export { isKebabId } from '../id.js';
+const KebabIdentifierSchema = (label) => z.string().superRefine((value, ctx) => {
+    if (!isKebabId(value)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: `${label} must be kebab-case with lowercase letters, numbers, and single hyphen separators`,
+        });
+    }
+});
+export const InitiativeLinkSchema = z.object({
+    store: KebabIdentifierSchema('Store id'),
+    id: KebabIdentifierSchema('Initiative id'),
+}).strict();
+/** Top-level keys ChangeMetadataSchema recognizes. Anything else is ignored. */
+export const CHANGE_METADATA_KNOWN_KEYS = [
+    'schema',
+    'created',
+    'goal',
+    'affected_areas',
+    'initiative',
+    'retire_capabilities',
+];
+// Per-change metadata schema. The schema field is validated against available
+// workflow schemas when metadata is read or written.
+export const ChangeMetadataSchema = z.object({
+    schema: z.string().min(1, { message: 'schema is required' }),
+    created: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, {
+        message: 'created must be YYYY-MM-DD format',
+    })
+        .optional(),
+    goal: z.string().min(1).optional(),
+    affected_areas: z.array(z.string().min(1)).optional(),
+    initiative: InitiativeLinkSchema.optional(),
+    // Declares that this change may retire a capability: when its REMOVED entries
+    // take the last requirement a capability has, archive deletes that
+    // capability's main spec instead of aborting on a spec it could not write
+    // (#1302). Required because the deletion is not recoverable from the working
+    // tree - only from git - so it is the author's call, not an inference from the
+    // shape of a delta.
+    retire_capabilities: z.boolean().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/core/change-status-policy.d.ts

@@ -0,0 +1,49 @@
+import type { PlanningHome } from './planning-home.js';
+export interface PlanningHomeSummary {
+    kind: 'repo';
+    root: string;
+    changesDir: string;
+    defaultSchema: string;
+}
+export interface ActionContext {
+    mode: 'repo-local';
+    sourceOfTruth: 'repo';
+    planningArtifacts: string[];
+    linkedContext: Array<{
+        name: string;
+    }>;
+    allowedEditRoots: string[];
+    requiresAffectedAreaSelection: boolean;
+    constraints: string[];
+}
+export interface ChangeStatusPolicyArtifact {
+    id: string;
+    status: 'done' | 'skipped' | 'ready' | 'blocked';
+}
+export interface ChangeNextStepsInput {
+    changeName: string;
+    artifactStatuses: ChangeStatusPolicyArtifact[];
+    allArtifactsComplete: boolean;
+}
+export interface ActionContextInput {
+    projectRoot: string;
+    artifactIds: string[];
+}
+export declare function summarizePlanningHome(planningHome: PlanningHome | undefined): PlanningHomeSummary | undefined;
+export declare function buildActionContext(input: ActionContextInput): ActionContext;
+/**
+ * The one next action for a change, in both the forms the CLI needs.
+ *
+ * `sentence` is what the JSON `nextSteps` contract publishes; `command` is the
+ * bare command the text surface prints. Both are built here so the two
+ * surfaces can never name a different next step.
+ */
+export interface ChangeNextStep {
+    /** Ready-to-run command. */
+    command: string;
+    /** Sentence form carried by the JSON `nextSteps` array. */
+    sentence: string;
+}
+export declare function resolveNextStep(input: ChangeNextStepsInput): ChangeNextStep | undefined;
+export declare function buildNextSteps(input: ChangeNextStepsInput): string[];
+//# sourceMappingURL=change-status-policy.d.ts.map

package/dist/core/change-status-policy.js

@@ -0,0 +1,50 @@
+export function summarizePlanningHome(planningHome) {
+    if (!planningHome) {
+        return undefined;
+    }
+    return {
+        kind: planningHome.kind,
+        root: planningHome.root,
+        changesDir: planningHome.changesDir,
+        defaultSchema: planningHome.defaultSchema,
+    };
+}
+export function buildActionContext(input) {
+    const scope = editScope(input);
+    // Keys stay in the published contract order.
+    return {
+        mode: 'repo-local',
+        sourceOfTruth: 'repo',
+        planningArtifacts: input.artifactIds,
+        linkedContext: [],
+        allowedEditRoots: scope.allowedEditRoots,
+        requiresAffectedAreaSelection: false,
+        constraints: scope.constraints,
+    };
+}
+function editScope(input) {
+    return {
+        allowedEditRoots: [input.projectRoot],
+        constraints: ['Repo-local change artifacts and implementation edits are scoped to this project.'],
+    };
+}
+export function resolveNextStep(input) {
+    const readyArtifact = input.artifactStatuses.find((artifact) => artifact.status === 'ready');
+    if (readyArtifact) {
+        const command = `freespec instructions ${readyArtifact.id} --change "${input.changeName}" --json`;
+        return { command, sentence: `Run ${command} before writing that artifact.` };
+    }
+    if (input.allArtifactsComplete) {
+        const command = `freespec instructions apply --change "${input.changeName}" --json`;
+        return {
+            command,
+            sentence: `All planning artifacts are complete. Run ${command} to inspect implementation progress.`,
+        };
+    }
+    return undefined;
+}
+export function buildNextSteps(input) {
+    const step = resolveNextStep(input);
+    return step ? [step.sentence] : [];
+}
+//# sourceMappingURL=change-status-policy.js.map

package/dist/core/command-generation/adapters/amazon-q.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Amazon Q Developer Command Adapter
+ *
+ * Formats commands for Amazon Q Developer following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Amazon Q adapter for command generation.
+ * File path: .amazonq/prompts/freespec-<id>.md
+ * Frontmatter: description
+ *
+ * Amazon Q surfaces these files as its prompt library rather than as slash
+ * commands: the user types `@freespec-propose`, not `/freespec-propose`.
+ * https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-prompts.html
+ */
+export declare const amazonQAdapter: ToolCommandAdapter;
+//# sourceMappingURL=amazon-q.d.ts.map

package/dist/core/command-generation/adapters/amazon-q.js

@@ -0,0 +1,32 @@
+/**
+ * Amazon Q Developer Command Adapter
+ *
+ * Formats commands for Amazon Q Developer following its frontmatter specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Amazon Q adapter for command generation.
+ * File path: .amazonq/prompts/freespec-<id>.md
+ * Frontmatter: description
+ *
+ * Amazon Q surfaces these files as its prompt library rather than as slash
+ * commands: the user types `@freespec-propose`, not `/freespec-propose`.
+ * https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-prompts.html
+ */
+export const amazonQAdapter = {
+    toolId: 'amazon-q',
+    getFilePath(commandId) {
+        return path.join('.amazonq', 'prompts', `freespec-${commandId}.md`);
+    },
+    invocationPrefix: '@',
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=amazon-q.js.map

package/dist/core/command-generation/adapters/antigravity.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Antigravity Command Adapter
+ *
+ * Formats commands for Antigravity following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Antigravity adapter for command generation.
+ * File path: .agents/workflows/freespec-<id>.md
+ * Frontmatter: description
+ */
+export declare const antigravityAdapter: ToolCommandAdapter;
+//# sourceMappingURL=antigravity.d.ts.map

package/dist/core/command-generation/adapters/antigravity.js

@@ -0,0 +1,27 @@
+/**
+ * Antigravity Command Adapter
+ *
+ * Formats commands for Antigravity following its frontmatter specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Antigravity adapter for command generation.
+ * File path: .agents/workflows/freespec-<id>.md
+ * Frontmatter: description
+ */
+export const antigravityAdapter = {
+    toolId: 'antigravity',
+    getFilePath(commandId) {
+        return path.join('.agents', 'workflows', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=antigravity.js.map

package/dist/core/command-generation/adapters/atomcode.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AtomCode Command Adapter
+ *
+ * Formats project commands for AtomCode.
+ * https://github.com/atomgit-atomcode/atomcode#custom-commands
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * AtomCode adapter for command generation.
+ * File path: .atomcode/commands/freespec-<id>.md
+ * Frontmatter: name, description, args
+ *
+ * AtomCode's custom-command parser reads name and args literally without YAML
+ * unquoting, so these controlled identifiers must stay unquoted.
+ * The command name matches the filename.
+ *
+ * `args` mirrors what the workflow actually accepts. AtomCode executes an
+ * `args: none` command straight from the slash menu, while `optional` completes
+ * to `/name ` and waits for a second Enter. Advertising arguments a workflow
+ * never reads would cost every user that extra keystroke, so only workflows
+ * carrying an `**Input**:` contract declare `optional` and receive $ARGUMENTS.
+ */
+export declare const atomcodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=atomcode.d.ts.map

package/dist/core/command-generation/adapters/atomcode.js

@@ -0,0 +1,46 @@
+/**
+ * AtomCode Command Adapter
+ *
+ * Formats project commands for AtomCode.
+ * https://github.com/atomgit-atomcode/atomcode#custom-commands
+ */
+import path from 'path';
+import { stringify } from 'yaml';
+/** A workflow declares its invocation input with an `**Input**:` heading. */
+const INPUT_HEADING = /^\*\*Input\*\*:/m;
+/**
+ * AtomCode adapter for command generation.
+ * File path: .atomcode/commands/freespec-<id>.md
+ * Frontmatter: name, description, args
+ *
+ * AtomCode's custom-command parser reads name and args literally without YAML
+ * unquoting, so these controlled identifiers must stay unquoted.
+ * The command name matches the filename.
+ *
+ * `args` mirrors what the workflow actually accepts. AtomCode executes an
+ * `args: none` command straight from the slash menu, while `optional` completes
+ * to `/name ` and waits for a second Enter. Advertising arguments a workflow
+ * never reads would cost every user that extra keystroke, so only workflows
+ * carrying an `**Input**:` contract declare `optional` and receive $ARGUMENTS.
+ */
+export const atomcodeAdapter = {
+    toolId: 'atomcode',
+    getFilePath(commandId) {
+        return path.join('.atomcode', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        // Keep ordinary descriptions plain for the literal custom-command parser,
+        // while keeping special values valid YAML for frontmatter consumers.
+        const description = stringify({ description: content.description }, { lineWidth: 0, blockQuote: false });
+        const acceptsInput = INPUT_HEADING.test(content.body);
+        const argumentsBlock = acceptsInput ? '\n**Provided arguments**: $ARGUMENTS\n' : '';
+        return `---
+name: freespec-${content.id}
+${description}args: ${acceptsInput ? 'optional' : 'none'}
+---
+${argumentsBlock}
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=atomcode.js.map

package/dist/core/command-generation/adapters/auggie.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Auggie (Augment CLI) Command Adapter
+ *
+ * Formats commands for Auggie following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Auggie adapter for command generation.
+ * File path: .augment/commands/freespec-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export declare const auggieAdapter: ToolCommandAdapter;
+//# sourceMappingURL=auggie.d.ts.map

package/dist/core/command-generation/adapters/auggie.js

@@ -0,0 +1,28 @@
+/**
+ * Auggie (Augment CLI) Command Adapter
+ *
+ * Formats commands for Auggie following its frontmatter specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Auggie adapter for command generation.
+ * File path: .augment/commands/freespec-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export const auggieAdapter = {
+    toolId: 'auggie',
+    getFilePath(commandId) {
+        return path.join('.augment', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+argument-hint: command arguments
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=auggie.js.map

package/dist/core/command-generation/adapters/bob.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Bob Shell Command Adapter
+ *
+ * Formats commands for Bob Shell following its markdown specification.
+ * Commands are stored in .bob/commands/ directory.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Bob Shell adapter for command generation.
+ * File path: .bob/commands/freespec-<id>.md
+ * Frontmatter: description
+ *
+ * Bob uses the filename (minus .md) as the slash command name, so
+ * freespec-propose.md → /freespec-propose. generateCommand rewrites the body's
+ * command references to that form before this adapter formats it.
+ */
+export declare const bobAdapter: ToolCommandAdapter;
+//# sourceMappingURL=bob.d.ts.map

package/dist/core/command-generation/adapters/bob.js

@@ -0,0 +1,33 @@
+/**
+ * Bob Shell Command Adapter
+ *
+ * Formats commands for Bob Shell following its markdown specification.
+ * Commands are stored in .bob/commands/ directory.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Bob Shell adapter for command generation.
+ * File path: .bob/commands/freespec-<id>.md
+ * Frontmatter: description
+ *
+ * Bob uses the filename (minus .md) as the slash command name, so
+ * freespec-propose.md → /freespec-propose. generateCommand rewrites the body's
+ * command references to that form before this adapter formats it.
+ */
+export const bobAdapter = {
+    toolId: 'bob',
+    getFilePath(commandId) {
+        return path.join('.bob', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+argument-hint: command arguments
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=bob.js.map