/init

Initialize the fractary-spec plugin in the current project.

This command:

1. Creates configuration file from example
2. Creates /specs directory
3. Initializes archive index
4. Sets up integration with fractary-work and fractary-file

Usage

/fractary-spec:init

What It Does

1. Copy Configuration:

   • Copies config.example.json to project's config location
   • User can customize settings afterward

2. Create Specs Directory:

   • Creates /specs directory (or configured path)
   • This is where active specs are stored

3. Initialize Archive Index (Two-Tier Storage):

   • Local Cache: .fractary/plugins/spec/archive-index.json
     • Fast access for lookups
     • Git-ignored (not in version control)
   • Cloud Backup: archive/specs/.archive-index.json
     • Durable storage, recoverable if local lost
     • Synced automatically during archival
   • On init, attempts to sync from cloud if available
   • If cloud unavailable or empty, creates new local index

4. Verify Dependencies:

   • Checks fractary-work plugin installed
   • Checks fractary-file plugin installed
   • Warns if missing

Output

First-Time Init (No Cloud Index)

🎯 Initializing fractary-spec plugin...

✓ Configuration created: .fractary/plugins/spec/config.json
✓ Specs directory created: /specs
ℹ No cloud index found, creating new local index
✓ Archive index initialized: .fractary/plugins/spec/archive-index.json
✓ Dependencies verified:
  - fractary-work: ✓ Installed
  - fractary-file: ⚠ Not available (cloud sync disabled)

✅ fractary-spec plugin initialized!

Next steps:
1. Review configuration: .fractary/plugins/spec/config.json
2. Generate your first spec: /fractary-spec:generate <issue>

Init with Cloud Sync (Recovering Lost Local Environment)

🎯 Initializing fractary-spec plugin...

✓ Configuration created: .fractary/plugins/spec/config.json
✓ Specs directory created: /specs
Syncing archive index from cloud...
✓ Archive index synced from cloud
✓ Local cache updated: .fractary/plugins/spec/archive-index.json
✓ Dependencies verified:
  - fractary-work: ✓ Installed
  - fractary-file: ✓ Installed

✅ fractary-spec plugin initialized!
✅ Recovered 15 archived specs from cloud index!

Next steps:
1. Review configuration: .fractary/plugins/spec/config.json
2. Read archived specs: /fractary-spec:read <issue>

Configuration

After initialization, review and customize:

{
  "storage": {
    "local_path": "/specs",
    "cloud_archive_path": "archive/specs/{year}/{issue_number}.md"
  },
  "archive": {
    "auto_archive_on": {
      "issue_close": true,
      "pr_merge": true,
      "faber_release": true
    }
  }
}

Troubleshooting

Error: Directory already exists:

• Safe to run multiple times
• Existing config not overwritten

Warning: Dependencies not found:

• Install fractary-work plugin
• Install fractary-file plugin
• Required for full functionality

---

<IMPLEMENTATION> **Run the init script to create the configuration:**

bash plugins/spec/skills/spec-initializer/scripts/init.sh

The script will:

1. Create .fractary/plugins/spec/config.json with defaults
2. Create specs/ directory for spec files
3. Create .fractary/plugins/spec/archive-index.json for tracking
4. Set secure file permissions (600)
5. Output JSON with the result

With options:

# Force overwrite existing config
bash plugins/spec/skills/spec-initializer/scripts/init.sh --force

After running the script:

1. Parse the JSON output to check status
2. If status is "success": Display success message and next steps
3. If status is "exists": Inform user config already exists
4. If status is "failure": Display error message

Success output should include:

✅ Fractary Spec Plugin initialized!

Configuration: .fractary/plugins/spec/config.json
Specs directory: specs/
Archive index: .fractary/plugins/spec/archive-index.json

Next steps:
1. Generate your first spec: /fractary-spec:create --work-id 123
2. Review configuration: cat .fractary/plugins/spec/config.json

</IMPLEMENTATION>